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

Number field

Числовое поле с кнопками изменения значения.

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

Песочница

Number Field

По умолчанию

API

NumberField.Root

СвойствоТипПо умолчаниюОписание
valuenumber—Текущее число, делающее поле управляемым.
defaultValuenumber—Начальное число неуправляемого поля.
onValueChange(value: number | undefined) => void—Вызывается с разобранным числом или undefined, если поле ввода пустое.
minnumber—Минимальное допустимое значение.
maxnumber—Максимальное допустимое значение.
stepnumber1Величина, добавляемая или вычитаемая кнопками увеличения и уменьшения.
formatOptionsIntl.NumberFormatOptions—Параметры Intl.NumberFormat для отображения значения.
clampValueOnBlurbooleantrueВозвращает значение за пределами диапазона в границы min и max при потере фокуса.
disabledbooleanfalseОтключает поле ввода и обе кнопки изменения значения.
readOnlybooleanfalseРазрешает только чтение значения, сохраняя возможность фокуса на поле ввода.
requiredbooleanfalseПомечает поле ввода обязательным для валидации формы.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

NumberField.Group

СвойствоТипПо умолчаниюОписание
childrenReactNode—Поле ввода и кнопки изменения значения, обёрнутые группой.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

NumberField.Input

СвойствоТипПо умолчаниюОписание
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

NumberField.Increment

СвойствоТипПо умолчаниюОписание
childrenReactNode—Содержимое кнопки увеличения.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

NumberField.Decrement

СвойствоТипПо умолчаниюОписание
childrenReactNode—Содержимое кнопки уменьшения.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

Клавиатура

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

Доступность

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

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

data-uiify-number-fielddata-disabled