Перейти к содержимому
v2.5.0
English
Русский
Документация

PinField

PinField — составной компонент для кодов фиксированной длины, таких как одноразовые коды (OTP) и PIN.

Подписи

  • Сопровождайте поле видимым Label.
  • PinFieldInput — семантический элемент формы, и именно на нём должны быть атрибуты, связанные с формой.

Поведение клавиатуры

ОбъявлениеПереведите фокус на демо и нажмите клавишу из таблицы.
КлавишаДействие
BackspaceУдаляет символ перед кареткой. Фокус остаётся в поле: за ячейками стоит одно поле ввода.
Каждая строка проверена в настоящем браузере: Playwright нажимает клавишу в Chromium и смотрит, где оказались фокус и активный элемент.
  • Ввод с клавиатуры обрабатывается через PinFieldInput.
  • Стрелки перемещают позицию активного слота; вверх и Home ведут в начало, вниз и End — в конец.
  • Shift со стрелкой нативно расширяет выделение.

Поведение фокуса

  • Фокус попадает на PinFieldInput, а видимые слоты отражают активное состояние.
  • При потере фокуса индикатор активного слота сбрасывается.

Семантика для скринридеров

  • PinFieldInput сохраняет доступность поля для вспомогательных технологий и браузерного автозаполнения.
  • Видимые слоты — лишь сегментированное представление того же значения.

Семантика форм

  • Задавайте name, required и другие пропсы формы на PinFieldInput.
  • Число слотов должно соответствовать maxLength.

Риски доступности

  • отсутствие PinFieldInput
  • опора только на видимые слоты без настоящего элемента управления за ними
  • неясные подписи в сценариях одноразовых кодов (OTP) или подтверждения