PinInput

Базовый (4 ячейки)

Код: —

Длина и маска

Размеры

Состояния

Входные параметры

ИмяТипПо умолчаниюОписание
lengthnumber4Количество ячеек.
size'sm' | 'md' | 'lg'undefinedРазмер ячеек. Если не задан, берётся из C3FormField.
disabledbooleanfalseОтключает ввод.
errorbooleanfalseФлаг ошибки.
namestringundefinedИмя поля.
maskstring''Символ-заглушка, отображаемый вместо введённой цифры.

v-model привязывает код (строку из цифр) через defineModel<string>({ default: '' }).

Описание

Компонент C3PinInput — поле ввода PIN-кода из нескольких ячеек с автоматическим переходом фокуса между ними. Принимает только цифры, поддерживает вставку кода целиком.

Используйте length для количества ячеек и mask для скрытия введённых цифр (например, «•»).

Дополнительная информация

  • Слоты отсутствуют.
  • Контейнер имеет роль group без подписи; каждая ячейка — <input> с inputmode="numeric" и autocomplete="one-time-code".
  • Навигация: ввод цифры переводит фокус вперёд; Backspace в пустой ячейке и стрелки ArrowLeft/ArrowRight перемещают между ячейками.
  • Вставка (paste) заполняет код сразу, оставляя только цифры.
  • Компонент интегрируется с C3FormField: берёт ошибку из контекста и регистрирует геттер значения для валидации.
×