Slider

View in ClayDocumentationLIFERAY DXP

A Slider allows the user to select values in a linear range of values.

A horizontal bar with a handler is a Slider

Usage

Use a Slider when you need a selection from a range of values where we want the user to play with the possible values. A popular use is changing the contrast color value for an image. Other uses could be: setting the volume of audio, the reproduction bar of a video or adjusting a filter in a faceted search, etc.

A Slider shows a range of values along a bar, from which users may select a single value. It has default values for its range: min to max — 0 to 100, each. However, these values can be tailored depending on what’s needed.

STEPS

Additionally, a step value can be set. A step specifies the size of each thumb movement (the increment or jump between values) of the Slider control. Layout

Layout

A schema with three points showing the Slider
  1. Progress, this shows the value of the range selected. Can be transparent.
  2. Thumb, this is used as a knob to select a specific value from the range.
  3. Track, this is the rail where the thumb moves. It represents the full range of values.

States

Active

A Slider with blue progress

Hover

A Slider with blue progress and mouse cursor: pointer The browser will determine the cursor to display based on the current context

Disabled

A Slider with progress and track dimmed

Focused

The thumb has a blue line coating it

Interaction

MOUSE

  1. Once the thumb moves, it updates the slider value
  2. A mouse click/tap on the track moves the thumb to that point in the track
  3. If a step is defined, the click/tap moves the thumb to a step in the track.

Tooltip

It shows the current slider value. Showing the tooltip is optional as a slider can be combined with other components (inputs, labels, etc). It’s shown when the user hovers over the thumb.

The number 87 is shown on top of the thumb

Drag and Drop

The Thumb only moves horizontally so It can be dragged and dropped from right to left and left to right.

The thumb has a subtle blue color Thumb Hover

The thumb has a subtle blue color and it's coated with a blue line Thumb Drag

KEYBOARD

  • Right Arrow: Increase the value of the slider by one step.
  • Up Arrow: Increase the value of the slider by one step.
  • Left Arrow: Decrease the value of the slider by one step.
  • Down Arrow: Decrease the value of the slider by one step.
  • Home: Set the slider to the first allowed value in its range (minimum).
  • End: Set the slider to the last allowed value in its range (maximum.
  • Page Up: Increment the slider by an amount larger than the step change made by Up Arrow.
  • Page Down: Decrement the slider by an amount larger than the step change made by Down Arrow.