# vehicle-keyboard-js

**Repository Path**: iRainIoT/vehicle-keyboard-js

## Basic Information

- **Project Name**: vehicle-keyboard-js
- **Description**: 停车王车牌号码专用键盘 - 基于Vue.js
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 234
- **Forks**: 59
- **Created**: 2017-11-08
- **Last Updated**: 2025-04-17

## Categories & Tags

**Categories**: vue-extensions

**Tags**: None

## README

# 停车王车牌号码专用键盘 VehicleKeyboard - vue.js

`VehicleKeyboard`是停车王品牌的各端产品线的基础组件，专为提高中国车牌号码输入速度而定制开发的专用键盘组件，包括以下三个项目：

- `Android` Android项目，为Android客户端定制包括输入组件、键盘组件及相关控制逻辑实现；
- `iOS` iOS客户端项目，为iOS客户端定制包括输入组件、键盘组件及相关控制逻辑实现；
- `JavaScript(Vue.js)` JavaScript(Vue.js)项目，为H5页面定制，包括Web、微信、支付宝等，同样包括输入组件、键盘组件及相关控制逻辑实现

# 一、项目主页

## 1.1 Android 版本
- GitHub项目主页： [https://github.com/parkingwang/vehicle-keyboard-android](https://github.com/parkingwang/vehicle-keyboard-android)
- OSChina项目主页： [https://gitee.com/iRainIoT/vehicle-keyboard-android](https://gitee.com/iRainIoT/vehicle-keyboard-android)

## 1.2 iOS 版本
- GitHub项目主页： [https://github.com/parkingwang/vehicle-keyboard-ios](https://github.com/parkingwang/vehicle-keyboard-ios)
- OSChina项目主页： [https://gitee.com/iRainIoT/vehicle-keyboard-ios](https://gitee.com/iRainIoT/vehicle-keyboard-ios)

## 1.3 JavaScript Vue.js 版本
- GitHub项目主页： [https://github.com/parkingwang/vehicle-keyboard-js](https://github.com/parkingwang/vehicle-keyboard-js)
- OSChina项目主页： [https://gitee.com/iRainIoT/vehicle-keyboard-js](https://gitee.com/iRainIoT/vehicle-keyboard-js)


![](keyboard.jpeg)

# 二、使用说明

## 2.1 键盘输入框混合组件

[键盘输入框混合组件](./MixedKeyboardUsage.md)

混合组件包括键盘和输入框两部分组件，具有完成的车牌输入逻辑。

基于VUE.js实现的单组件，单JS文件，包含vue核心库，文件大小约 116KB。

## 2.2 单键盘组件

[单键盘组件的使用方法](./SingleKeyboardUsage.md)

单键盘组件只包含键盘组件部分。

基于VUE.js实现的单组件，单JS文件，包含vue核心库，文件大小约 108KB。

## 2.3 单独车牌键盘引擎文件

Android、iOS目前版本会依赖此内核文件，使用其`native_update_keyboard`来生成键盘布局和键位。
界面UI部分，Android和iOS使用平台原生的组件来实现。

> VehicleEngine.js

# 三、键盘内部规则设计说明

## 3.1 键盘逻辑引擎

[键盘逻辑引擎](./Engine.md)

## 3.2 车牌号码规则

1. 参见：[中国车牌号码编码规则全解](http://yoojia.xyz/2018/05/09/chinese-vehicle-number/)
1. 参见：[中华人民共和国民用机动车号牌](https://zh.wikipedia.org/wiki/中华人民共和国民用机动车号牌)


## 已知问题

- 在 Android4.4 以下的浏览器或者WebView中，由于不支持CSS3部分特性，会出现输入框界面宽度变化的问题；

# 四、版本更新记录

### v2017.0320

- 修改快捷省份按键样式；
- 在键盘类型为2（“民用+武警”）模式中增加大使馆车辆类型；

### v2017.1117

- 增加“民航”车牌类型；
- 移除车牌号码末位“练”字符；
- 调整键位圆角参数为4px；
- 修复MixedKeyboard中单个可用按键没有自动提交的问题；

### v2017.1108

- 完成基础功能，更新文档并公开发布；

# 五、开发

开发时运行开发环境：

> npm run dev

发布时生成JS文件：

> npm run build

生成三个JS文件：

1. MixedKeyboard.js 混合了输入框的组件；
2. SingleKeyboard.js 只有键盘组件，需要由应用自身实现输入框样式和逻辑；
3. VehicleEngine.js 车牌键盘内核逻辑文件，Android、iOS项目目前依赖此文件的实现；

# 维护

- [陈永佳](https://github.com/yoojia) chenyongjia@parkingwang.com