Slider – Carbon Design System

Sliders provide a visual indication of adjustable content, where the user can increase or decrease the value by moving the handle along a horizontal track.

Overview
Live demo
Interactions
Best practices
Feedback

Overview

The slider in its basic form should be accompanied by a label and a number input that doubles as a display for the slider’s current value.

The basic slider does not include discrete values, as the slider represents a percentage of 0-100. In this case it is not necessary for a user to choose a specific value, but instead generally increase or decrease an input. For example, the user increases the slider amount and the volume of the music gets louder.

The more complex versions should be used for selecting a specific value within a value range.

Live demo

Theme selector

Slider label

100

CodeSandbox React Angular Vue Vanilla


  <div className="some-container">
<Slider
  ariaLabelInput="Label for slider value"
  id="slider"
  labelText="Slider label"
  max={100}
  min={0}
  step={1}
  stepMuliplier={4}
  value={50}
/>
</div>


  <div className="some-container">
<Slider
  ariaLabelInput="Label for slider value"
  id="slider"
  labelText="Slider label"
  max={100}
  min={0}
  step={1}
  stepMuliplier={4}
  value={50}
/>
</div>

Interactions

Users can choose a numerical value by:

Entering the exact value into the text field.
Moving the slider handle with their mouse, which automatically updates the value in the text input.
Using the ↑ ↓ ← → arrow keys automatically updates the value in the text input and moves the slider handle to the corresponding value.
The step size increment is how many increments the inputted value and slider handle will jump when using the arrow keys. Make sure to set the step size increments to reasonable values.
↑ ↓ ← → changes the value by one step size increment. Example: Pressing → changes the inputted value from 59 to 60, increasing the value by 1 unit.
Shift + ↑ ↓ ← → changes the value by 10 step size increments. Example: Typing Shift + → changes the value from 60 to 70, increasing the inputted value by 10 units.

Best practices

The slider label should indicate what value the slider is changing.
Range values are used to describe the range in numbers.
Do not use for ranges that are extremely large i.e. 1-1000.
Do not use for ranges that are too small i.e. 1-3.

Feedback

Help us improve this component by providing feedback, asking questions, and leaving any other comments on GitHub.

Edit this page on GitHub

Components: Select

Slider: Style