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

Select

Обёртка над нативным элементом select.

Браузеры
Chrome 135+Firefox 121+
Почему указана эта версия?

Firefox keeps the native select control. This custom styling uses ::picker(select), :open, and option::checkmark, which Firefox does not support yet.

Safari 17+
Почему указана эта версия?

Safari keeps the native select control. This custom styling uses ::picker(select), :open, and option::checkmark, which Safari does not support yet.

Уровень
0
Сжатый размер
480 B
Лимит принудительной компоновки
0 ms
Лимит axe
0
Совместим с SSR
Да
Публичный контракт
Тестовый стенд

Песочница

Select

По умолчанию

С группами

Питомец

С разделителями

Длинное значение

API

Select.Root

СвойствоТипПо умолчаниюОписание
childrenReactNode—Части Select, обычно Select.Content с пунктами и группами.
valuestring—Выбранное значение, делающее select управляемым.
defaultValuestring—Значение, выбранное при первом рендеринге; далее выбором владеет нативный select, поэтому он работает без JavaScript.
onValueChange(value: string) => void—Вызывается с новым значением при изменении выбора.
namestring—Имя поля формы, отправляемое с выбранным значением.
disabledbooleanfalseОтключает нативный select и задаёт атрибут data-disabled.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

Select.Content

СвойствоТипПо умолчаниюОписание
childrenReactNode—Пункты, группы и разделители; часть отображает дочерние элементы без дополнительной обёртки.

Select.Item

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

Select.Group

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

Select.Separator

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

Клавиатура

КлавишаДействие
Arrow keysИзменить вариант при наличии фокуса
SpaceОткрыть нативный выбор (зависит от платформы)

Доступность

Нативный <select> только с текстом; браузер обеспечивает выбор, ввод с клавиатуры, поиск вводом символов и отправку формы. В поддерживающих браузерах улучшается только внешний вид списка выбора.

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

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