Клавиатура VehicleKeyboard для ввода автомобильных номеров — компонент для различных продуктов Parkingwang

VehicleKeyboard — это базовый компонент для продуктов Parkingwang, который был разработан специально для ускорения ввода китайских автомобильных номеров. Он включает в себя три проекта:

• Android — проект для Android-клиента, включающий компоненты ввода, клавиатуру и связанную логику управления;
• iOS — проект для iOS-клиента с компонентами ввода, клавиатурой и связанной логикой управления;
• JavaScript (Vue.js) — проект для H5-страниц, включая Web, WeChat и Alipay, также с компонентами ввода и клавиатуры и связанной логикой управления.

1. Проектные страницы

1.1. Версия для Android

• Страница проекта на GitHub: https://github.com/parkingwang/vehicle-keyboard-android.
• Страница проекта на OSChina: https://gitee.com/iRainIoT/vehicle-keyboard-android.

1.2. Версия для iOS

• Страница проекта на GitHub: https://github.com/parkingwang/vehicle-keyboard-ios.
• Страница проекта на OSChina: https://gitee.com/iRainIoT/vehicle-keyboard-ios.

1.3. Версия JavaScript Vue.js

• Страница проекта на GitHub: https://github.com/parkingwang/vehicle-keyboard-js.
• Страница проекта на OSChina: https://gitee.com/iRainIoT/vehicle-keyboard-js.

2. Использование

2.1. Смешанный компонент клавиатуры Смешанный компонент включает две части — клавиатуру и поле ввода. Он имеет полную логику ввода номера автомобиля. Это однокомпонентное решение на Vue.js, которое содержит только один файл JS и ядро библиотеки Vue. Размер файла составляет около 116 КБ.

2.2. Однокомпонентная клавиатура Однокомпонентная клавиатура включает только часть клавиатуры. Это также однокомпонентное решение на Vue.js с одним файлом JS, содержащим ядро библиотеки Vue. Файл имеет размер около 108 КБ.

2.3. Ядро файла для клавиатуры В настоящее время версии для Android и iOS зависят от этого ядра. Они используют native_update_keyboard для создания макета клавиатуры и клавиш. Для реализации интерфейса используются собственные компоненты платформы.

VehicleEngine.js

3. Правила проектирования клавиатуры

3.1. Логика клавиатуры

3.2. Правила автомобильных номеров Правила основаны на следующих источниках:

• Китайские правила кодирования автомобильных номеров: http://yoojia.xyz/2018/05/09/chinese-vehicle-number/.
• Автомобильные номера Китайской Народной Республики: https://zh.wikipedia.org/wiki/中华人民共和国民用机动车号牌.

Известные проблемы

• В браузерах или WebView ниже Android 4.4 может возникнуть проблема с изменением ширины поля ввода из-за отсутствия поддержки некоторых функций CSS3.

4. История версий

v2017.0320

• Изменён стиль кнопок быстрого доступа к провинциям.
• Добавлен тип «大使馆» для автомобилей дипломатических миссий в режиме клавиатуры «2» («民用 + 武警»).

v2017.1117

• Добавлена категория «民航».
• Удалён символ «练» в конце номера.
• Скорректирован параметр радиуса углов клавиш до 4 пикселей.
• Исправлена проблема, когда отдельные доступные клавиши не автоматически отправляли данные в MixedKeyboard.

v2017.1108

• Завершена базовая функциональность, обновлены документы и начата публикация.

5. Разработка

Для запуска среды разработки используется команда npm run dev. Для генерации файлов JS при публикации используется команда npm run build. Генерируются следующие файлы:

• MixedKeyboard.js — смешанный компонент с полем ввода;
• SingleKeyboard.js — только клавиатура, поле ввода должно быть реализовано приложением самостоятельно;
• VehicleEngine.js — ядро логики клавиатуры, на которое в настоящее время полагаются проекты для Android и iOS.

Поддержка

Чэнь Юнцзя, chenyongjia@parkingwang.com.