Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/parkingwang/vehicle-keyboard-js
停车王车牌号码专用键盘 - 基于vue.js
https://github.com/parkingwang/vehicle-keyboard-js
Last synced: about 2 months ago
JSON representation
停车王车牌号码专用键盘 - 基于vue.js
- Host: GitHub
- URL: https://github.com/parkingwang/vehicle-keyboard-js
- Owner: parkingwang
- License: other
- Created: 2017-11-08T06:27:00.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-07-26T02:43:36.000Z (about 6 years ago)
- Last Synced: 2024-06-27T09:35:37.853Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 294 KB
- Stars: 215
- Watchers: 10
- Forks: 58
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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)
# 二、使用说明
## 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) [email protected]