keyboardView
来自于:开发者立即使用
addKeyboardListener removeKeyboardListener
论坛示例
为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码供您参考。
概述
keyboardView实现了iOS、Android系统下监听键盘弹出,并在键盘顶部增加自定义按钮,方便实现复杂的一些app使用场景。(iOS使用情况下,使用该模块的页面禁止使用alert提示,否则会引起键盘循环显示和隐藏导致App卡死)。
模块效果图
模块接口
addKeyboardListener
设置键盘顶部按钮监听事件
addKeyboardListener({params}, callback(ret,err))
params
height:
- 类型:数字型
- 描述:(可选项)键盘顶部按钮布局高度。
- 默认值:40
backgroundColor:
- 类型:字符串
- 描述:(可选项)顶部布局背景颜色代码。
- 默认值:#FFFFFF
lineColor:
- 类型:字符串
- 描述:(可选项)顶部横线颜色代码。
- 默认值:#F8F8FF
data:
- 类型: 数组对象
- 描述:(必填项)顶部按钮id和图标
- 内部字段:
[{
id: '', //(可选项)字符串;按钮ID
icon: '', //(可选项)字符串;按钮图标,支持fs:// widget://默认:App图标
}]
callback(ret,err)
ret:
- 类型:JSON对象
- 内部字段:
{
status: true, //布尔型;true|false
evenType : 'init',//状态类型 init、show、hide、click
id :'', //按钮点击时返回按钮序号(click有效)
}
err:
- 类型:JSON 对象
- 内部字段:
{
msg:''
}
示例代码
var demo = api.require('keyboardView');
demo.addKeyboardListener({
height : 40,
lineColor : '#e6e6e6',
backgroundColor : '#fdfdfe',
data : [{
id : 'name0',
icon : 'widget://res/ic_category_0.png'
},{
id : 'name1',
icon : 'widget://res/ic_category_1.png'
},{
id : 'name2',
icon : 'widget://res/ic_category_2.png'
},{
id : 'name3',
icon : 'widget://res/ic_category_3.png'
},{
id : 'name4',
icon : 'widget://res/ic_category_4.png'
}],
fixedOn : api.frameName,
fixed : true,
}, function(ret, err){
//iOS禁止alert弹出,否则会卡死
api.toast({ msg : JSON.stringify(ret),location:'top' });
});
可用性
iOS、Android系统
可提供的1.0.0及更高版本
removeKeyboardListener
移除键盘顶部按钮监听事件
removeKeyboardListener(callback(ret,err))
callback(ret,err)
ret:
- 类型:JSON对象
- 内部字段:
{
status: true, //布尔型;true|false
}
err:
- 类型:JSON 对象
- 内部字段:
{
msg:''
}
示例代码
var demo = api.require('keyboardView');
demo.removeKeyboardListener(function(ret, err){
alert(JSON.stringify(ret));
});
可用性
iOS、Android系统
可提供的1.0.0及更高版本