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和图标
  • 内部字段:
  1. [{
  2. id: '', //(可选项)字符串;按钮ID
  3. icon: '', //(可选项)字符串;按钮图标,支持fs:// widget://默认:App图标
  4. }]

callback(ret,err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true|false
  3. evenType : 'init',//状态类型 init、show、hide、click
  4. id :'', //按钮点击时返回按钮序号(click有效)
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:''
  3. }

示例代码

  1. var demo = api.require('keyboardView');
  2. demo.addKeyboardListener({
  3. height : 40,
  4. lineColor : '#e6e6e6',
  5. backgroundColor : '#fdfdfe',
  6. data : [{
  7. id : 'name0',
  8. icon : 'widget://res/ic_category_0.png'
  9. },{
  10. id : 'name1',
  11. icon : 'widget://res/ic_category_1.png'
  12. },{
  13. id : 'name2',
  14. icon : 'widget://res/ic_category_2.png'
  15. },{
  16. id : 'name3',
  17. icon : 'widget://res/ic_category_3.png'
  18. },{
  19. id : 'name4',
  20. icon : 'widget://res/ic_category_4.png'
  21. }],
  22. fixedOn : api.frameName,
  23. fixed : true,
  24. }, function(ret, err){
  25. //iOS禁止alert弹出,否则会卡死
  26. api.toast({ msg : JSON.stringify(ret),location:'top' });
  27. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

removeKeyboardListener

移除键盘顶部按钮监听事件

removeKeyboardListener(callback(ret,err))

callback(ret,err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true|false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:''
  3. }

示例代码

  1. var demo = api.require('keyboardView');
  2. demo.removeKeyboardListener(function(ret, err){
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本