Компонент клавиатуры SingleKeyboard.js

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

В использовании он имеет функцию обновления номера на клавиатуре:

• native_update_keyboard(presetNumber, keyboardType, provinceName, numberType, inputIndex) — эта функция обновляет номерной знак на компоненте ввода клавиатуры. Вот описание соответствующих параметров:
  • presetNumber: String, обязательный параметр. Предустановленный номерной знак. Может быть пустым номерным знаком или полным номерным знаком. Обратите внимание: параметр не может быть пустым, если это пустой номерной знак, то следует установить пустую строку «».
  • keyboardType: Int, необязательный параметр. Указывает тип клавиатуры. Типы следующие:
    • 0 — полная клавиатура для номерного знака;
    • 1 — только гражданская клавиатура для номерного знака;
    • 2 — гражданская + специальная клавиатура для номерного знака.
  • provinceName — название провинции пользователя, например «провинция Гуандун». Используется для отображения аббревиатуры провинции. Если этот параметр является пустой строкой «», отображаются все провинции.
  • numberType: тип номерного знака транспортного средства.
  • inputIndex: позиция номерного знака на клавиатуре, указывающая, в каком положении находится текущий номерной знак клавиатуры. Обратите внимание: когда установлено отрицательное число, длина предустановленного номерного знака используется как позиция.

Предоставляются следующие интерфейсы обратного вызова:

• native_callback_changed(number, isCompleted) — функция обратного вызова, которая вызывается при изменении номерного знака после нажатия пользователем на клавиатуру.

  • number: String, текущий вводимый номерной знак, частично или полностью, используется вместе с isCompleted;
  • isCompleted: Boolean, указывает, был ли введён номерной знак полностью.

• native_callback_completed(number, isAutoCompleted) — функция обратного вызова, вызываемая после завершения ввода номерного знака, эта функция обратного вызова гарантирует целостность номерного знака. Завершение ввода номерного знака включает два состояния:

  • во время изменения номерного знака пользователь активно нажимает кнопку «подтвердить» до того, как будет вызван этот обратный вызов;
  • когда номерной знак достигает последней позиции, он автоматически вызывается.

• native_callback_show_message(message) — функция обратного вызова для отображения информации о подсказке.

• native_callback_onrawkey(key) — при нажатии любой клавиши на клавиатуре всегда вызывается эта функция.

• native_callback_ontextkey(text) — когда нажимается текстовая клавиша на клавиатуре, вызывается этот обратный вызов.

• native_callback_ondelkey() — при нажатии клавиши удаления на клавиатуре вызывается этот обратный вызов.

• native_callback_onokkey() — когда пользователь нажимает клавишу подтверждения на клавиатуре, вызывается этот обратный вызов.

Использование на веб-странице

Первый шаг:

Объявите тег DIV для отображения клавиатуры на HTML-странице и импортируйте файл SingleKeyboard.js:

<div id="single-keyboard-box">
  <single-keyboard :args="args" :callbacks="callbacks"/>
</div>
<script src="SingleKeyboard.js"></script>

Примечание:

1. Необходимо сохранить id DIV как single-keyboard-box. Также необходимо сохранить настройки внутри компонента (причина в том, что код launcher в keyboard.js использует эти настройки).
2. Обратите внимание на имя компонента внутри DIV, оно отличается от имени компонента «смешанная клавиатура», его имя — single-keyboard.

Второй шаг:

Создайте глобальную функцию обратного вызова:

// Эта функция будет вызвана после завершения ввода
function native_callback_completed(number, isAutoCompleted) {
    alert("Номерной знак автомобиля введён: " + number + "，автоматически завершено?" + isAutoCompleted);
}

// Эта функция будет вызываться при изменении номера во время ввода,
function native_callback_changed(number, isCompleted){
    alert("Вводимый номер: " + number + "，завершено ли:" + isCompleted);
}

// Когда нужно отобразить сообщение пользователю, например, при переключении типа клавиатуры и т. д., вызовите эту функцию, чтобы отобразить сообщение.
function native_callback_show_message(message){
    alert(message);
}

// Обработка логики нажатия на текстовую клавишу
function native_callback_ontextkey(text) {
    // text — это текст текущей нажатой клавиши.
}

// Обработка логики нажатия клавиши удаления
function native_callback_ondelkey() {
    
}

// Обработка логики нажатия кнопки подтверждения
function native_callback_onokkey() {
    
}

Третий шаг:

Вызовите глобальные функции для инициализации клавиатуры:

... ВАШ КОД ЗДЕСЬ...
// Первый параметр — предустановленный номерной знак: текущий введённый номерной знак. При отсутствии номерного знака введите пустую строку “”.
// Второй параметр — тип клавиатуры: временно 1, что означает: гражданская клавиатура.
// Третий параметр — провинция: без провинции введите пустую строку “”.
// Четвёртый параметр — тип номерного знака: по умолчанию 0, что означает автоматическое определение версии. Также можно указать 5, что означает новый энергетический номерной знак.
// Пятый параметр — текущий номерной знак ввода. По умолчанию -1, что означает использование длины предустановленного номера в качестве номера ввода.
native_update_keyboard("京A12345", 1, "провинция Гуандун", 0, -1);

... ВАШ КОД ЗДЕСЬ...

Четвёртый шаг:

Если необходимо управлять отображением/скрытием DIV в соответствии с управлением, это можно реализовать, управляя состоянием div#single-keyboard-box.