Перейти к основному содержимому

Slider

Отображает ползунок

Используется для задания значений из непрерывного диапазона или диапазона дискретных значений.

Выбор значения возможен путем перемещения бегунка, либо путем щелчка мыши в диапазоне допустимых значений.

  <Slider />

Свойства​

Badge​

Количественная информация в компонентах Menu, Accordion, Link, Text.

В качестве значения может использоваться объект с полями: counter (число), position ("post" или "pre"), color (цвет)

Тип: any

CSS​

Массив строк-классов CSS-стилей, описанных в файле CSS.css разрабатываемого проекта или встроенных CSS-стилей Платформы.

Пример:

// внешние (m) и внутренние (p) отступы для компонента. Число после символа "-" (в этом примере - 4) должно быть кратно величине, указанной в параметре, определяющем кратность отступов, в файле Style.mdtheme разрабатываемого проекта.
CSS={["m-4", "p-4"]}

Тип: array

CombineConfig​

Служебное свойство, используемое в визуальном режиме Редактора Форм, для присваивания значений свойствам компонента в виде генерируемых блоков кода. Запрещено изменять значение.

Тип: object

Hidden​

Признак состояния компонента Скрыт.

Тип: boolean

Hint​

Текст, отображаемый при наведении указателя мыши на компонент. Текст отображается на белом фоне

Тип: any

Id​

Идентификатор компонента для навигации к нему на HTML-странице. Подробнее см. HTML id Attribute или ID

Тип: string

KeyField​

Имя поля объекта в массиве State, которое содержит идентификатор текстового значения ValueField, отображаемого в компоненте.

Тип: string

Model​

Псевдоним свойств Value и OutputValue.

Тип: any

OnClick​

Обработчик события нажатия левой кнопки мыши, когда указатель мыши находится на компоненте.

В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnClick={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnKeyDown​

Обработчик события нажатия любой клавиши клавиатуры. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа KeyboardEvent.

Пример:

OnKeyDown={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnKeyUp​

Обработчик события отпускания любой клавиши клавиатуры. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа KeyboardEvent.

Пример:

OnKeyUp={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnMouseDown​

Обработчик события нажатия любой кнопки мыши, когда указатель мыши находится на компоненте. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnMouseDown={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnMouseEnter​

Обработчик события перемещения указателя мыши на компонент. Событие срабатывает только в случае, если указатель мыши находится за пределами компонента и пользователь перемещает указатель мыши внутрь компонента. Если указатель мыши в текущий момент находится внутри компонента, для срабатывания события пользователь должен переместить указатель мыши за пределы компонента, а затем обратно внутрь компонента. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnMouseEnter={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnMouseLeave​

Обработчик события перемещения указателя мыши за пределы компонента. Событие срабатывает, только если указатель мыши находится внутри компонента, а пользователь перемещает указатель мыши за пределы компонента. Если указатель мыши в текущий момент находится за пределами компонента, для срабатывания события пользователь должен переместить указатель мыши внутрь компонента, а затем обратно за пределы компонента. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnMouseLeave={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnMouseMove​

Обработчик события наведения указателя мыши на компонент. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnMouseMove={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnMouseOut​

Обработчик события перемещения указателя мыши за пределы компонента. Когда пользователь наводит указатель мыши на компонент, происходит одно событие MouseOver, за которым следует одно или несколько событий MouseMove, когда пользователь перемещает указатель мыши внутри компонента. Одно событие MouseOut возникает, когда пользователь выводит указатель мыши за пределы компонента. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnMouseOut={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnMouseOver​

Обработчик события перемещения указателя мыши на компонент. Событие возникает, когда пользователь наводит указатель мыши на компонент, и не повторяется до тех пор, пока пользователь не выведет указатель мыши за пределы компонента и затем не вернет его обратно. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnMouseOver={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnMouseUp​

Обработчик события отпускания кнопки мыши, когда указатель мыши находится на компоненте. В качестве параметра принимает объект типа объект события компонента экранной формы с дополнительными полями типа MouseEvent.

Пример:

OnMouseUp={() => {
  // Получение параметра события
  const event = getEvent();
  // Вывод параметра события в консоль браузера
  console.log(event);
  }
}

Тип: undefined

OnUnmount​

Обработчик события размонтирования согласно жизненному циклу экранной формы. Не имеет параметров.

Пример:

OnUnmount={() => {
  // Отмена выполнения периодического действия при размонтировании экранной формы
    return clearInterval(getValue("pleerInterval"))
  }
}

Тип: undefined

OutputValue​

Привязка отрисованного компонента к модели.

Тип: any

Point​

Признак типа ползунка дискретного диапазона.

Тип: boolean

Size​

Предопределенный размер ползунка в пикселях.

Тип: enum

Значение по умолчанию: normal

Возможные значения:

short - Укороченный — 104 px normal - Стандартный — 248 px

Slot​

Именованное пространство во фрагменте экранной формы или именованное пространство в шаблоне компонента с возможностью шаблонизации, например, Select, DataGrid.

Тип: string

State​

Массив объектов, среди полей которых есть хотя бы одно поле, содержащее текст ValueField для отображения, и хотя бы одно поле, содержащее идентификатор KeyField этого текста.

Тип: array

Step​

Размер интервала между метками для ползунка дискретного диапазона.

Тип: number

Значение по умолчанию: 1

Tooltip​

Текст, отображаемый при наведении указателя мыши на компонент. Текст отображается на черном фоне.

Тип: any

TraceId​

Идентификатор для отслеживания состояния компонента исходя из жизненного цикла экранной формы. Используется для выполнения фрагмента кода по изменению состояния компонента

Тип: string

Unit​

Символ для обозначения единицы измерения выбранного значения.

Тип: string

Значение по умолчанию: %

Value​

Предустановленное положение индикатора, показывающего текущее значение.

Тип: string

ValueField​

Имя поля объекта в массиве State, которое содержит текст, отображаемый в компоненте.

Тип: string

Visible​

Признак инверсии состояния компонента Скрыт.

Тип: boolean

Значение по умолчанию: True

Примеры​

Данные:

  "simpleSlider": 10, "simpleShortSlider": 50, "pointSlider": "day", "pointShortSlider": "year"
}

JSX:

<Group Mode={"Column"}>
    <Group Mode="Row" Height="auto" CSS={['mb-24']}>
      <Group Mode="Column" Width="170px" CSS={['mr-24']}>
        <Text Mode="Medium_20" Value="Default" CSS={['mb-24']} />
        <Text Mode="Regular_14_2" Value="Самый простой слайдер." />
      </Group>
      <Group Mode="Column" CSS={['mt-24', 'mr-24']} Width="330px">
        <Text Mode="Medium_18" Value="" CSS={['mb-24']} />
  
        <Group Height="auto">
          <Slider
            Model-var="simpleSlider"
          />
        </Group>
      </Group>
      <Group Mode="Column" CSS={['mt-24']}>
        <Text Mode="Medium_18" Value="" CSS={['mb-24']} />
  
        <Group Height="auto">
          <Slider
            Model-var="simpleShortSlider"
            Size="short"
          />
        </Group>
      </Group>
    </Group>
    <Group Mode="Row">
      <Group Mode="Column" Width="170px" CSS={['mr-24']}>
        <Text Mode="Medium_20" Value="Point" CSS={['mb-24']} />
        <Text Mode="Regular_14_2" Value="Позволяет выбирать значения заранее заданные на слайдере." />
      </Group>
      <Group Mode="Column" CSS={['mt-24', 'mr-24']} Width="330px">
        <Text Mode="Medium_18" Value="" CSS={['mb-24']} />
  
        <Group Height="auto">
          <Slider
            Model-var="pointSlider"
            Point={true}
            State={[
              { key: 'day', value: 'день' },
              { key: 'week', value: 'нед.' },
              { key: 'month', value: 'мес.' },
              { key: 'year', value: 'год' },
              { key: 'quarter', value: 'квартал' }
            ]}
            KeyField="key"
            ValueField="value"
          />
        </Group>
      </Group>
      <Group Mode="Column" CSS={['mt-24']}>
        <Text Mode="Medium_18" Value="" CSS={['mb-24']} />
  
        <Group Height="auto">
          <Slider
            Model-var="pointShortSlider"
            Size="short"
            Point={true}
            State={[
              { key: 'day', value: 'день' },
              { key: 'week', value: 'нед.' },
              { key: 'month', value: 'мес.' },
              { key: 'year', value: 'год' },
              { key: 'quarter', value: 'квартал' }
            ]}
            KeyField="key"
            ValueField="value"
          />
        </Group>
      </Group>
    </Group>
  </Group>