К содержимому
uiify

Field

Обёртка для подписи, элемента управления и ошибки.

Браузеры
Chrome 123+Firefox 121+Safari 17.5+
Уровень
0
Сжатый размер
668 B
Лимит принудительной компоновки
0 ms
Лимит axe
0
Совместим с SSR
Да
Публичный контракт
Тестовый стенд

Песочница

Field

По умолчанию

Your display name

Invalid

Password

Use at least eight characters.

Message

Up to 500 characters.

Отключена

Read only

API

Field.Root

СвойствоТипПо умолчаниюОписание
id*string—Стабильный идентификатор, который каждая часть передаёт как fieldId, связывая подпись, элемент управления, описание и ошибку в серверной разметке.
invalidbooleanfalseПомечает поле невалидным и отражает это в data-invalid для оформления.
requiredbooleanfalseПомечает поле обязательным и отражает это в data-required для оформления.
disabledbooleanfalseПомечает поле отключённым и отражает это в data-disabled для оформления.
namestring—Принимается для совместимости API; имя относится к элементу управления и не выводится на обёртке.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

Field.Label

СвойствоТипПо умолчаниюОписание
fieldId*string—Тот же идентификатор, что у Field.Root; определяет htmlFor, указывающий на элемент управления.
disabledbooleanfalseПомечает подпись отключённой и отражает это в data-disabled для оформления.
requiredbooleanfalseПомечает подпись обязательной и отражает это в data-required для оформления.

Field.Control

СвойствоТипПо умолчаниюОписание
asElementType"div"Используйте input, textarea, select или собственный элемент управления. Нативные свойства, обработчики событий, style и ref передаются дальше.
type / name / autoComplete / minLength / maxLength / pattern / readOnlynative control props—Параметры ввода задаются на Field.Control, в том числе type="password". Стандартная семантика валидации и FormData сохраняется.
fieldId*string—Тот же идентификатор, что у Field.Root; определяет id элемента управления и его связи aria-labelledby и aria-describedby.
disabledbooleanfalseПередаёт нативный disabled в input, textarea и select и отражает его в data-disabled.
invalidbooleanfalseЗадаёт aria-invalid и добавляет сообщение об ошибке в aria-describedby элемента управления.
requiredbooleanfalseПередаёт нативный required в input, textarea и select, а также задаёт aria-required.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

Field.Description

СвойствоТипПо умолчаниюОписание
fieldId*string—Тот же идентификатор, что у Field.Root; определяет id описания, на которое ссылается элемент управления.
disabledbooleanfalseПомечает описание отключённым и отражает это в data-disabled для оформления.

Field.Error

СвойствоТипПо умолчаниюОписание
fieldId*string—Тот же идентификатор, что у Field.Root; определяет id ошибки, на которую ссылается невалидный элемент управления.
invalidbooleanfalseОтображает сообщение об ошибке; при false часть ничего не отображает.

Клавиатура

КлавишаДействие
TabПеревести фокус на элемент управления или с него
Enter / SpaceАктивировать при наличии фокуса (для элементов управления типа кнопки)

Доступность

По возможности используется семантический HTML. Изучите разметку в песочнице: ARIA добавляется только там, где нативных элементов недостаточно.

Привязка стилей

data-disabled
Эта страница переведена автоматически и ещё не проверена.