dtCarKeyBoard

来自于:开发者立即使用

概述

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对象
  • 描述:
  • 内部字段:
{
    isValid: true,        // 车牌号是否有效
    isEnergy: false,     // 是否为新能源车牌
    plate: '京A88888',    // 输入的车牌号
}

示例代码

var carKeyboard = api.require('dtCarKeyBoard');
carKeyboard.open({
    defaultPlate: '京A',
    tintColor: '#ff0',
    showInput: true,
    isEnergy: false,
    autoHide: true
}, function(ret){
    alert(JSON.stringify(ret));
});

可用性

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

close

关闭键盘

close()

示例代码

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

可用性

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

show

显示键盘

show()

示例代码

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

可用性

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

hide

隐藏键盘

hide()

示例代码

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

可用性

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