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){
    api.alert({msg: JSON.stringify(ret)});
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18