PinInput
Базовый (4 ячейки)
Код: —
Длина и маска
Размеры
Состояния
Входные параметры
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
length | number | 4 | Количество ячеек. |
size | 'sm' | 'md' | 'lg' | undefined | Размер ячеек. Если не задан, берётся из C3FormField. |
disabled | boolean | false | Отключает ввод. |
error | boolean | false | Флаг ошибки. |
name | string | undefined | Имя поля. |
mask | string | '' | Символ-заглушка, отображаемый вместо введённой цифры. |
v-model привязывает код (строку из цифр) через defineModel<string>({ default: '' }).
Описание
Компонент C3PinInput — поле ввода PIN-кода из нескольких ячеек с автоматическим переходом фокуса между ними. Принимает только цифры, поддерживает вставку кода целиком.
Используйте length для количества ячеек и mask для скрытия введённых цифр (например, «•»).
Дополнительная информация
- Слоты отсутствуют.
- Контейнер имеет роль
groupбез подписи; каждая ячейка —<input>сinputmode="numeric"иautocomplete="one-time-code". - Навигация: ввод цифры переводит фокус вперёд;
Backspaceв пустой ячейке и стрелкиArrowLeft/ArrowRightперемещают между ячейками. - Вставка (paste) заполняет код сразу, оставляя только цифры.
- Компонент интегрируется с
C3FormField: берёт ошибку из контекста и регистрирует геттер значения для валидации.