keyboardView

来自于:开发者立即使用

概述

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及更高版本