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

Slider

Ползунок для выбора одного значения или диапазона между двумя границами.

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

Песочница

Slider

Slider по умолчанию

Управляемый Slider

Slider с отметками

Slider для диапазона

Вертикальный Slider

Отключённый Slider

API

Slider

СвойствоТипПо умолчаниюОписание
valuenumber—Текущее значение, делающее ползунок управляемым.
defaultValuenumber—Начальное значение неуправляемого ползунка; далее им владеет нативное поле range.
onValueChange(value: number) => void—Вызывается с новым числом при каждом перемещении ползунка.
minnumber0Минимальное доступное для выбора значение.
maxnumber100Максимальное доступное для выбора значение.
stepnumber1Шаг между доступными значениями.
disabledbooleanfalseОтключает нативное поле ввода и задаёт атрибут data-disabled.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

SliderClient

СвойствоТипПо умолчаниюОписание
valuenumber | readonly [number, number]—Управляемое значение; кортеж отображает нижний и верхний бегунки.
defaultValuenumber | readonly [number, number]—Начальное значение нативного поля range или диапазона с двумя бегунками.
onValueChange(value: number | readonly [number, number]) => void—Вызывается при изменении выбранного значения или упорядоченного диапазона.
minnumber0Минимальное доступное для выбора значение.
maxnumber100Максимальное доступное для выбора значение.
stepnumber | null1Числовой шаг сохраняет нативное изменение до гидратации; null после гидратации ограничивает значения min, max и отметками.
marksreadonly { value: number; label?: ReactNode }[]—Подписи делений и точки привязки при step равном null.
orientation"horizontal" | "vertical""horizontal"Направление компоновки элемента управления и его отметок.
thumbLabelsreadonly [string, string]—Доступные названия нижнего и верхнего бегунков диапазона.
disabledbooleanfalseОтключает все нативные поля range.
renderReactElement | ((props, state) => ReactElement)—Заменяет отображаемый элемент, сохраняя поведение и связи доступности.

Клавиатура

КлавишаДействие
Arrow keysИзменить нативное поле range в фокусе на один шаг или до следующей отметки
Home / EndПереместить бегунок в фокусе к минимуму или максимуму
TabПеремещаться между нижним и верхним бегунками диапазона

Доступность

Slider формирует нативное поле range, которое работает до гидратации и при отключённом JavaScript. SliderClient также формирует нативные поля range на сервере, а после гидратации управляет ими для значений диапазона, подписанных отметок и неравномерной привязки. Числовой step сохраняет нативный шаг до гидратации; привязка к отметкам при step={null} начинает работать после неё. Задайте одиночному ползунку aria-label или aria-labelledby; обоим бегункам диапазона задайте thumbLabels.

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

data-uiify-sliderdata-uiify-slider-clientdata-part="root"data-part="track"data-part="range"data-part="mark"data-part="thumb"data-orientationdata-disableddata-enhanced--uiify-slider-start--uiify-slider-end--uiify-slider-position
Эта страница переведена автоматически и ещё не проверена.