decimalRangeSlider
Начиная с Jmix 3.1
decimalRangeSlider позволяет выбрать диапазон значений типа Double. На шкале компонента два ползунка: один задаёт начало диапазона, другой — его конец.
Для значений типа Integer используйте integerRangeSlider. Чтобы выбрать одно значение, используйте decimalSlider.
XML-элемент |
|
|---|---|
Java-класс |
|
Основы
По умолчанию слайдер принимает значения от 0 до 100 с шагом 1, а выбранный диапазон занимает всю шкалу. Чтобы задать исходный диапазон, используйте атрибуты startValue и endValue. Если задан только один из них, второй получает значение min или max.
Пример decimalRangeSlider, который принимает значения от 0 до 1 с шагом 0,1:
<decimalRangeSlider id="decimalRangeSlider" label="DecimalRangeSlider" width="20em"
min="0" max="1" step="0.1"
startValue="0.2" endValue="0.8"
valueAlwaysVisible="true"
helperText="The value bubbles are always visible"/>Значение
Значение decimalRangeSlider — это запись (record) DecimalRangeSliderValue. Её методы start() и end() возвращают начало и конец выбранного диапазона. Значение start() не может быть больше end().
Чтобы задать диапазон в коде, передайте в метод setValue() новый объект DecimalRangeSliderValue(start, end). Метод clear() выбирает весь диапазон от min до max.
decimalRangeSlider нельзя связать с контейнером данных, и он не поддерживает валидаторы. Значение слайдера можно получить в контроллере экрана. Пример слайдера диапазона, который фильтрует данные, приведён на странице integerRangeSlider. Чтобы показать ошибку, задайте атрибут errorMessage и вызовите setInvalid(true) в контроллере.
Слайдер отправляет новое значение на сервер, когда пользователь отпускает ползунок. Чтобы значение отправлялось на каждом шаге перетаскивания, установите для атрибута valueChangeMode значение EAGER.
Диапазон и шаг
Атрибуты min и max задают диапазон значений, а step — интервал между ними. Значения, которые может выбрать пользователь, отсчитываются от min: min, min + step, min + 2 * step и так далее. Смотрите пример выше.
Отображение значений
По умолчанию слайдер показывает текущие значения в пузырьках над ползунками, только пока пользователь взаимодействует с ними. Установите для атрибута valueAlwaysVisible значение true, чтобы значения были видны всегда, как в примере выше.
Атрибут minMaxVisible показывает значения min и max под шкалой.
Доступные имена
Программы чтения с экрана озвучивают доступное имя каждого ползунка. По умолчанию имена строятся на основе надписи компонента (атрибут label). Чтобы задать другие имена, используйте атрибуты accessibleNameStart и accessibleNameEnd.
Атрибуты
decimalRangeSlider имеет следующие уникальные атрибуты:
| Имя | Описание | По умолчанию |
|---|---|---|
Задаёт доступное имя ползунка, отвечающего за конец диапазона. См. Доступные имена. |
— |
|
Задаёт доступное имя ползунка, отвечающего за начало диапазона. См. Доступные имена. |
— |
|
Задаёт конец исходного диапазона. Если задан только |
— |
|
Задаёт максимальное значение слайдера. См. Диапазон и шаг. |
|
|
Задаёт минимальное значение слайдера. См. Диапазон и шаг. |
|
|
Показывает значения |
|
|
Показывает индикатор обязательного поля. Компонент не проверяет своё значение. |
|
|
Задаёт начало исходного диапазона. Если задан только |
— |
|
Задаёт интервал между значениями, которые может выбрать пользователь. Шаг должен быть больше 0. См. Диапазон и шаг. |
|
|
Определяет, всегда ли отображаются текущие значения над ползунками. Если |
|
decimalRangeSlider имеет следующие общие атрибуты:
id - alignSelf - classNames - colspan - css - enabled - errorMessage - focusShortcut - height - helperText - justifySelf - label - maxHeight - maxWidth - minHeight - minWidth - readOnly - tabIndex - valueChangeMode - valueChangeTimeout - visible - width
Элементы
Компонент decimalRangeSlider может содержать вложенный элемент tooltip.