EditBox 组件参考

    点击 属性检查器 下面的 添加组件 按钮，然后从 UI 组件 中选择 EditBox，即可添加 EditBox 组件到节点上。

    EditBox 的脚本接口请参考 EditBox API。

    • 废弃 fontSize, fontColor, lineHeight, placeholderFontSize, placeholderFontColor, backgroundImage, stayOnTop 属性，Cocos Creator 会自动将这些属性的值升级为所挂载组件上的相应属性
    • 废弃 setFocus() 方法，新增 focus() 和 blur() 方法，为 EditBox 组件提供主动结束输入文本的能力

    editbox-event

    注意：该事件在用户点击输入框获取焦点的时候被触发。

    Text Changed 事件

    注意：该事件在用户每一次输入文字变化的时候被触发。

    Editing Return 事件

    注意：在用户按下回车键或者在移动端上点击软键盘的完成按钮时，该事件会被触发。如果是单行输入框，按回车键还会使输入框失去焦点。

    • Keyboard Return Type 特指在移动设备上面进行输入的时候，弹出的虚拟键盘上面的回车键样式。
    • 如果需要输入密码，则需要把 Input Flag 设置为 password，同时 Input Mode 必须是 Any 之外的选择，一般选择 Single Line。
    • 如果要输入多行，可以把 Input Mode 设置为 Any。
    • 背景图片支持九宫格缩放

    这种方法添加的事件回调和使用编辑器添加的事件回调是一样的，都是通过代码添加。首先需要构造一个 对象，然后设置好对应的 target、component、handler 和 customEventData 参数。

    方法二

    通过 editbox.node.on('editing-did-began', …) 的方式来添加

    1. // 假设我们在一个组件的 onLoad 方法里面添加事件处理回调，在 callback 函数中进行事件处理:
    3. cc.Class({
    4.     extends: cc.Component,
    6.        editbox: cc.EditBox
    9.     onLoad: function () {
    10.        this.editbox.node.on('editing-did-began', this.callback, this);
    11.     },
    13.     callback: function (editbox) {
    14.        // 回调的参数是 editbox 组件
    15.        // do whatever you want with the editbox
    16.     }