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对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. enenType : 'open', //open 打开键盘
  4. //click 点击数字
  5. //dot 小数点
  6. //delete 删除
  7. //longDelete 长按删除(安卓无效)
  8. value : 1, //点击数字时有效
  9. height : 203 //键盘真实高度,安卓此值不同手机有细微差别,请注意
  10. }

示例代码

  1. demo.openKeyboard({
  2. x : 0,
  3. y : api.frameHeight - 203,
  4. fixedOn : api.frameName,
  5. fixed : true
  6. }, function(ret, err) {
  7. if (ret.enenType == 'click') {
  8. api.toast({msg : JSON.stringify(ret)});
  9. } else {
  10. api.toast({msg : JSON.stringify(ret)});
  11. }
  12. });

可用性

iOS,Android系统

可提供的1.0.0及更高版本

hiddenKeyboard

隐藏数字键盘

hiddenKeyboard(callback(ret, err))

callback(ret, err)

ret:

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

err:

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

示例代码

  1. demo.hiddenKeyboard(function(ret, err) {
  2. api.toast({
  3. msg : JSON.stringify(ret)
  4. });
  5. });

可用性

iOS,Android系统

可提供的1.0.0及更高版本

showKeyboard

显示被隐藏的数字键盘

showKeyboard(callback(ret, err))

callback(ret, err)

ret:

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

err:

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

示例代码

  1. demo.showKeyboard(function(ret, err) {
  2. api.toast({
  3. msg : JSON.stringify(ret)
  4. });
  5. });

可用性

iOS,Android系统

可提供的1.0.0及更高版本

closeKeyboard

关闭打开的数字键盘

closeKeyboard(callback(ret, err))

callback(ret, err)

ret:

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

err:

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

示例代码

  1. demo.closeKeyboard(function(ret, err) {
  2. api.toast({
  3. msg : JSON.stringify(ret)
  4. });
  5. });

可用性

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对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. enenType : 'open' //open 打开输入框
  4. //touch 点击输入框,进入编辑模式,此时可以调用显示键盘
  5. }

示例代码

  1. demo.openEditText({
  2. x : 0,
  3. y : 0,
  4. h: 100,
  5. fixedOn : api.frameName,
  6. fixed : true,
  7. message : "消息记录。",
  8. placeholder : "你想说点什么?"
  9. },function(ret, err) {
  10. if(ret.enenType=='touch'){
  11. openCustomKeyboard();
  12. }
  13. api.toast({
  14. msg : JSON.stringify(ret)
  15. });
  16. });

可用性

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对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. enenType : 'open', //open 打开键盘
  4. //click 点击键盘按键返回
  5. //space 空格
  6. //delete 删除
  7. //longDelete 长按删除(安卓无效)
  8. //return 确定
  9. value : 1, //点击数字时有效
  10. completeValue : '',//缓存当前已经输入的文本内容
  11. height : 203 //键盘真实高度,安卓此值不同手机有细微差别,请注意
  12. }

示例代码

  1. demo.openCustomKeyboard({
  2. x : 0,
  3. y : api.frameHeight - 203,
  4. fixedOn : api.frameName,
  5. fixed : true,
  6. altLabel1 : '符号',
  7. altLabel2 : '英文',
  8. returnLabel : '确定',
  9. spaceLabel : '空格',
  10. 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'],
  11. 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'],
  12. charAlt : ['1','2','3','4','5','6','7','8','9','0','-','+','{','}','|','\\',':','"','<','>','?','~','!','@','#','$'],
  13. }, function(ret, err) {
  14. if (ret.enenType == 'click') {
  15. api.toast({
  16. msg : JSON.stringify(ret)+" "+JSON.stringify(err)
  17. });
  18. });

可用性

iOS,Android系统

可提供的1.0.0及更高版本

hiddenCustomKeyboard

隐藏字母键盘

hiddenCustomKeyboard(callback(ret, err))

callback(ret, err)

ret:

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

err:

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

示例代码

  1. demo.hiddenCustomKeyboard(function(ret, err) {
  2. api.toast({
  3. msg : JSON.stringify(ret)
  4. });
  5. });

可用性

iOS,Android系统

可提供的1.0.0及更高版本

showCustomKeyboard

显示被隐藏的字母键盘

showCustomKeyboard(callback(ret, err))

callback(ret, err)

ret:

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

err:

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

示例代码

  1. demo.showCustomKeyboard(function(ret, err) {
  2. api.toast({
  3. msg : JSON.stringify(ret)
  4. });
  5. });

可用性

iOS,Android系统

可提供的1.0.0及更高版本

closeCustomKeyboard

关闭打开的字母键盘

closeCustomKeyboard(callback(ret, err))

callback(ret, err)

ret:

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

err:

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

示例代码

  1. demo.closeCustomKeyboard(function(ret, err) {
  2. api.toast({
  3. msg : JSON.stringify(ret)
  4. });
  5. });

可用性

iOS,Android系统

可提供的1.0.0及更高版本