EditBox 组件参考

EditBox 是一种文本输入组件,该组件让你可以轻松获取用户输入的文本。 属性检查器下面的添加组件按钮,然后从添加 UI 组件中选择EditBox,即可添加 EditBox 组件到节点上。 EditBox API。

EditBox 属性

EditBox 事件

Editing Did Began 事件

说明:该事件在用户点击输入框获取焦点的时候被触发。

Text Changed 事件

说明:该事件在用户每一次输入文字变化的时候被触发。

Editing Did Ended 事件

如果是多行输入,一般是在用户点击屏幕输入框以外的地方调用该函数。

Editing Return 事件

说明:该事件在用户按下回车键的时候被触发, 如果是单行输入框,按回车键还会使输入框失去焦点。

详细说明

  • - stayOnTop 属性设置为 true

    通过脚本代码添加回调

    方法一
    你需要首先构造一个 cc.Component.EventHandler 对象,然后设置好对应的 target, component, handler 和 customEventData 参数。
    1. var editboxEventHandler = new cc.Component.EventHandler();editboxEventHandler.target = this.node; //这个 node 节点是你的事件处理代码组件所属的节点editboxEventHandler.component = "cc.MyComponent"editboxEventHandler.handler = "onEditDidBegan";editboxEventHandler.customEventData = "foobar";editbox.editingDidBegan.push(editboxEventHandler);// 你也可以通过类似的方式来注册其它回调函数//editbox.editingDidEnded.push(editboxEventHandler);//editbox.textChanged.push(editboxEventHandler);//editbox.editingReturn.push(editboxEventHandler);//here is your component filecc.Class({ name: 'cc.MyComponent' extends: cc.Component, properties: { }, onEditDidBegan: function(editbox, customEventData) { //这里 editbox 是一个 cc.EditBox 对象 //这里的 customEventData 参数就等于你之前设置的 "foobar" }, //假设这个回调是给 editingDidEnded 事件的 onEditDidEnded: function(editbox, customEventData) { //这里 editbox 是一个 cc.EditBox 对象 //这里的 customEventData 参数就等于你之前设置的 "foobar" } //假设这个回调是给 textChanged 事件的 onTextChanged: function(text, editbox, customEventData) { //这里的 text 表示 修改完后的 EditBox 的文本内容 //这里 editbox 是一个 cc.EditBox 对象 //这里的 customEventData 参数就等于你之前设置的 "foobar" } //假设这个回调是给 editingReturn 事件的 onEditingReturn: function(editbox, customEventData) { //这里 editbox 是一个 cc.EditBox 对象 //这里的 customEventData 参数就等于你之前设置的 "foobar" }});
    方法二
    editbox.node.on('editing-did-began', ...) 的方式来添加
    1. //假设我们在一个组件的 onLoad 方法里面添加事件处理回调,在 callback 函数中进行事件处理:cc.Class({ extends: cc.Component, properties: { editbox: cc.EditBox }, onLoad: function () { this.editbox.node.on('editbox', this.callback, this); }, callback: function (event) { //这里的 event 是一个 EventCustom 对象,你可以通过 event.detail 获取 EditBox 组件 var editbox = event.detail; //do whatever you want with the editbox }});同样的,你也可以注册 'editing-did-ended', 'text-changed' 和 'editing-return' 事件,这些事件的回调函数的参数与 'editing-did-began' 的参数一致。

MotionStreak 组件参考 说明文档。