dtCarKeyBoard

来自于:开发者立即使用

open close show hide

概述

dtCarKeyBoard 是一个车牌号输入的键盘模块,支持新能源车牌输入切换。

open

打开 dtCarKeyBoard 模块,该模块依附于keywindow之上,打开后,点击键盘上方空白处,会隐藏键盘。

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

params

defaultPlate:

  • 类型:字符串类型
  • 描述:(可选项)默认车牌号码,长度在0-8之间,否则不生效,如果长度等于8,则是新能源车牌号

defaultIndex:

  • 类型:整数
  • 描述:(可选项)键盘输入的初始位置索引,该数据范围:新能源在0-7之间,否则在0-6之间,该范围以外的数将会被强制更改为0
  • 默认:0,如果设置了defaultPlate,则为defaultPlate.length

isEnergy:

  • 类型:布尔类型
  • 描述:(可选项)是否输入新能源车牌号
  • 默认:false

showInput:

  • 类型:布尔类型
  • 描述:(可选项)是否在键盘上显示输入栏,输入栏可以动态切换新能源
  • 默认:true

tintColor:

  • 类型:字符串类型
  • 描述:(可选项)键盘上的输入栏的相对色调,如果showInput=false,则不生效
  • 默认:red

autoHide:

  • 类型:布尔类型
  • 描述:(可选项)车牌号输入完成后,是否自动检测车牌号的正确性,如果车牌合法,则自动隐藏键盘
  • 默认:true

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:
  • 内部字段:
  1. {
  2. isValid: true, // 车牌号是否有效
  3. isEnergy: false, // 是否为新能源车牌
  4. plate: '京A88888', // 输入的车牌号
  5. }

示例代码

  1. var carKeyboard = api.require('dtCarKeyBoard');
  2. carKeyboard.open({
  3. defaultPlate: '京A',
  4. tintColor: '#ff0',
  5. showInput: true,
  6. isEnergy: false,
  7. autoHide: true
  8. }, function(ret){
  9. alert(JSON.stringify(ret));
  10. });

可用性

iOS系统 可提供的1.0.0及更高版本

close

关闭键盘

close()

示例代码

  1. var carKeyboard = api.require('dtCarKeyBoard');
  2. carKeyboard.close();

可用性

iOS系统 可提供的1.0.0及更高版本

show

显示键盘

show()

示例代码

  1. var carKeyboard = api.require('dtCarKeyBoard');
  2. carKeyboard.show();

可用性

iOS系统 可提供的1.0.0及更高版本

hide

隐藏键盘

hide()

示例代码

  1. var carKeyboard = api.require('dtCarKeyBoard');
  2. carKeyboard.hide();

可用性

iOS系统 可提供的1.0.0及更高版本