keyboard

openKeyboard

hiddenKeyboard

showKeyboard

closeKeyboard

openEditText

openCustomKeyboard

hiddenCustomKeyboard

showCustomKeyboard

closeCustomKeyboard

概述

本插件封装了原生的数字键盘,26位字母键盘功能，方便开发者使用自定义的数字键盘布局。实现了数字键盘数字，小数点，删除按钮的监听，开发者对监听结果进行解析处理，实现自己的密码输入或者金额，字母等特殊需求输入等功能。

# **openKeyboard**

打开自定义的数字键盘界面。键盘的默认高度为203。位置的设置请自己进行处理。

openKeyboard({params},callback(ret, err))

params

x：

  • 类型：数字类型
  • 描述：（必填项）插件左上角的 x 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

y：

  • 类型：数字类型
  • 描述：（必填项）插件左上角的 y 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

dotLable：

  • 类型：字符串
  • 描述：（可选项）自定义数字键盘dot显示文本
  • 默认值：.

fixedOn：

  • 类型：字符串
  • 描述：（可选项）插件所属 Frame 的名字，若不传则插件归属于当前 Window

fixed：

  • 类型：布尔
  • 描述：（（可选项）插件是否随所属 Window 或 Frame 滚动
  • 默认值：true（不随之滚动）

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
    enenType : 'open', //open 打开键盘
                     //click 点击数字
                     //dot 小数点
                     //delete 删除
                     //longDelete 长按删除(安卓无效)
    value : 1, //点击数字时有效
    height : 203 //键盘真实高度,安卓此值不同手机有细微差别，请注意
}

示例代码

demo.openKeyboard({
    x : 0,
    y : api.frameHeight - 203,
    fixedOn : api.frameName,
    fixed : true
}, function(ret, err) {
    if (ret.enenType == 'click') {
        api.toast({msg : JSON.stringify(ret)});
    } else {
        api.toast({msg : JSON.stringify(ret)});
    }
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **hiddenKeyboard**

隐藏数字键盘

hiddenKeyboard(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true   //布尔型；true||false
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

demo.hiddenKeyboard(function(ret, err) {
    api.toast({
        msg : JSON.stringify(ret)
    });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **showKeyboard**

显示被隐藏的数字键盘

showKeyboard(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true   //布尔型；true||false
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

demo.showKeyboard(function(ret, err) {
    api.toast({
        msg : JSON.stringify(ret)
    });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **closeKeyboard**

关闭打开的数字键盘

closeKeyboard(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true   //布尔型；true||false
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

demo.closeKeyboard(function(ret, err) {
    api.toast({
        msg : JSON.stringify(ret)
    });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **openEditText**

打开自定义的文本编辑框，(注意：目前暂时只支持从文本最后删除和插入，不支持文本中进行插入和删除)。

openEditText({params},callback(ret, err))

params

x：

  • 类型：数字类型
  • 描述：（必填项）插件左上角的 x 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

y：

  • 类型：数字类型
  • 描述：（必填项）插件左上角的 y 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

w：

  • 类型：数字类型
  • 描述：（可选项）插件的宽度；默认：所属的 Window 或 Frame 的宽度

h：

  • 类型：数字类型
  • 描述：（可选项）插件的高度；默认：所属的 Window 或 Frame 的高度

fixedOn：

  • 类型：字符串
  • 描述：（可选项）插件所属 Frame 的名字，若不传则插件归属于当前 Window

fixed：

  • 类型：布尔
  • 描述：（（可选项）插件是否随所属 Window 或 Frame 滚动
  • 默认值：true（不随之滚动）

message：

  • 类型：字符串
  • 描述：（可选项）默认要显示的文本消息内容。

placeholder：

  • 类型：字符串
  • 描述：（可选项）当内容为空时显示的文本提示内容。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
    enenType : 'open' //open 打开输入框
                     //touch 点击输入框，进入编辑模式，此时可以调用显示键盘
}

示例代码

demo.openEditText({
    x : 0,
    y : 0,
    h: 100,
    fixedOn : api.frameName,
    fixed : true,
    message : "消息记录。",
    placeholder : "你想说点什么？"
},function(ret, err) {
    if(ret.enenType=='touch'){
        openCustomKeyboard();
    }
    api.toast({
        msg : JSON.stringify(ret)
    });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **openCustomKeyboard**

打开自定义的26位字母键盘界面。键盘的默认高度为203。位置的设置请自己进行处理。

openCustomKeyboard({params},callback(ret, err))

params

x：

  • 类型：数字类型
  • 描述：（必填项）插件左上角的 x 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

y：

  • 类型：数字类型
  • 描述：（必填项）插件左上角的 y 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

fixedOn：

  • 类型：字符串
  • 描述：（可选项）插件所属 Frame 的名字，若不传则插件归属于当前 Window

fixed：

  • 类型：布尔
  • 描述：（可选项）插件是否随所属 Window 或 Frame 滚动
  • 默认值：true（不随之滚动）

altLabel1：

  • 类型：字符串
  • 描述：（可选项）默认键盘时左下角alt键按显示文字
  • 默认值：符号

altLabel2：

  • 类型：字符串
  • 描述：（可选项）alt键按切换后左下角显示文字
  • 默认值：英文

returnLabel：

  • 类型：字符串
  • 描述：（可选项）右下角键按显示文字
  • 默认值：确定

spaceLabel：

  • 类型：字符串
  • 描述：（可选项）空格键按钮显示文字
  • 默认值：空格

charDefault：

  • 类型：数组
  • 描述：（必须项）默认显示在键盘上的信息，长度必须位26，可为小写26字母

charShift：

  • 类型：数组
  • 描述：（必须项）点击shift按钮切换在键盘上的信息，长度必须位26，可为大写26字母

charAlt：

  • 类型：数组
  • 描述：（必须项）点击alt按钮切换在键盘上的信息，长度必须位26，可为数字和特殊符号集合

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
    enenType : 'open', //open 打开键盘
                     //click 点击键盘按键返回
                     //space 空格
                     //delete 删除
                     //longDelete 长按删除(安卓无效)
                     //return 确定
    value : 1, //点击数字时有效
    completeValue : '',//缓存当前已经输入的文本内容
    height : 203 //键盘真实高度,安卓此值不同手机有细微差别，请注意
}

示例代码

demo.openCustomKeyboard({
    x : 0,
    y : api.frameHeight - 203,
    fixedOn : api.frameName,
    fixed : true,			
    altLabel1 : '符号',
    altLabel2 : '英文',
    returnLabel : '确定',
    spaceLabel : '空格',
    charDefault : ['q','w','e','r','t','y','u','i','o','p','a','s','d','f','g','h','j','k','l','z','x','c','v','b','n','m'],
    charShift : ['Q','W','E','R','T','Y','U','I','O','P','A','S','D','F','G','H','J','K','L','Z','X','C','V','B','N','M'],
    charAlt : ['1','2','3','4','5','6','7','8','9','0','-','+','{','}','|','\\',':','"','<','>','?','~','!','@','#','$'],
}, function(ret, err) {
    if (ret.enenType == 'click') {
        api.toast({
            msg : JSON.stringify(ret)+"  "+JSON.stringify(err)
        });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **hiddenCustomKeyboard**

隐藏字母键盘

hiddenCustomKeyboard(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true   //布尔型；true||false
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

demo.hiddenCustomKeyboard(function(ret, err) {
    api.toast({
        msg : JSON.stringify(ret)
    });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **showCustomKeyboard**

显示被隐藏的字母键盘

showCustomKeyboard(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true   //布尔型；true||false
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

demo.showCustomKeyboard(function(ret, err) {
    api.toast({
        msg : JSON.stringify(ret)
    });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

# **closeCustomKeyboard**

关闭打开的字母键盘

closeCustomKeyboard(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true   //布尔型；true||false
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

demo.closeCustomKeyboard(function(ret, err) {
    api.toast({
        msg : JSON.stringify(ret)
    });
});

可用性

iOS,Android系统

可提供的1.0.0及更高版本

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