键盘事件

优质
小牛编辑
112浏览
2023-12-01

输入框接口

用于弹起输入框,供用户输入文字。可以通过注册监听函数进行监听用户的输入,监听完毕请及时调用注销方法,取消监听。

BK.UI.showKeyboard(Object)

显示输入框,弹出键盘

手Q版本:7.6.5

函数参数Object:

属性名类型是否必填说明
deaultTextstring默认要展示的字符串
completeFunction接口调用完成回调

示例:

BK.UI.showKeyboard({
    defaultText:'默认值',
    complete:function(){
        BK.Script.log(0, 0, '弹出键盘成功');
    }
});

BK.UI.hideKeyboard(Object)

收起输入框与键盘

手Q版本:7.6.5

函数参数Object:

属性名类型是否必填说明
completeFunction接口调用完成回调

示例:

BK.UI.showKeyboard({
    defaultText:'默认值',
    complete:function(){
        BK.Script.log(0, 0, '弹出键盘成功');
    }
});

function doHide(){
    BK.UI.hideKeyboard({
        complete:function(){
            BK.Script.log(0, 0, '收起键盘完成');
        }
    })
};

BK.UI.updateKeyboard(Object)

更新输入框的文字

手Q版本:7.6.5

函数参数Object:

属性名类型是否必填说明
textstring要更新的字符串
completeFunction接口调用完成回调

示例:

BK.UI.updateKeyboard({
    text:"Boom!",
    success:function(succObj){
        BK.Script.log(0, 0, '更新完成');
    }
})

BK.UI.onKeyboardInput(Function(Object))

监听输入框的文字输入,输入框文字改变后会进行回调。可以在多处进行监听。

手Q版本:7.6.5

Object属性:

属性名类型说明
textstring改变后的输入框文字

示例:

function inputListener(data){
    BK.Script.log(0, 0, '更新后的文字:'+data.text);
}
BK.UI.onKeyboardInput(inputListener);

BK.UI.offKeyboardInput(Function(Object))

取消监听键盘的输入事件,需要传入与onKeyboardInput同一个函数,才能取消监听。

手Q版本:7.6.5

示例:

function inputListener(data){
    BK.Script.log(0, 0, '文字:'+data.text);
    if(data.text === 'cancel'){
        BK.UI.offKeyboardInput(inputListener);//取消监听
    }
}
BK.UI.onKeyboardInput(inputListener);//开始监听

BK.UI.onKeyboardConfirm(Function(Object))

监听点击“确认”按钮的事件,点击之后进行回调

手Q版本:7.6.5

Object属性:

属性名类型说明
textstring点击确认按钮时,输入框的文字

示例:

function confirmListener(data){
    BK.Script.log(0, 0, '点击了确认,文字:'+data.text);

    BK.UI.hideKeyboard({
        complete:function(){
            BK.Script.log(0, 0, '收起键盘complete');
        }
    })
}
BK.UI.onKeyboardConfirm(confirmListener);

BK.UI.offKeyboardConfirm(Function(Object))

取消监听点击“确认”按钮的事件。需要传入与offKeyboardConfirm同一个函数,才能取消监听。

手Q版本:7.6.5

示例:

function confirmListener(data){
    BK.Script.log(0, 0, '点击了确认,文字:'+data.text);

    BK.UI.hideKeyboard({
        complete:function(){
            BK.Script.log(0, 0, '收起键盘complete');
        }
    });
    BK.UI.offKeyboardConfirm(confirmListener);//取消监听
}
BK.UI.onKeyboardConfirm(confirmListener);