Using the slider role

This technique demonstrates how to use the slider role and describes the effect it has on browsers and assistive technology.

The slider role is used for markup that allows a user to select a value from within a given range. The slider role is assigned to the "thumb," the control that is adjusted to change the value. As the user interacts with the thumb, the application must programmatically adjust the slider's aria-valuenow (and possible aria-valuetext) attribute to reflect the current value. See the Examples section below for more information.

The slider should be keyboard focusable and operable. When the user tabs focus to the slider, it should land on the thumb: the control a mouse user would drag. Arrow keys should operate as follows (localization for right-to-left languages should reverse the direction of the arrows):

In the example below, a simple slider is used to select a value between 1 and 100. The current volume is 50. The application will programmatically update the value of aria-valuenow in response to user input.

<label for="fader">Volume</label>
<input type="range"
  id="fader"
  min="1"
  max="100"
  value="50"
  step="1"
  aria-valuemin="1"
  aria-valuemax="100"
  aria-valuenow="50"
  oninput="outputUpdate(value)">
<output for="fader" id="volume">50</output>

The following code snippet allows you to return the output as it is updated by user input:

function outputUpdate(vol) {
  document.querySelector('#volume').value = vol;
}

Sometimes, a slider is used to choose a value that is not, semantically, a number. In these cases, the aria-valuetext attribute is used to provide the appropriate text name for the currently selected value. In the example below, the slider is used to select a day of the week.

<label id="day-label">Days</label>
<div class="day-slider">
  <div id="day-handle" class="day-slider-handle" role="slider" aria-labelledby="day-label"
     aria-valuemin="1"
     aria-valuemax="7"
     aria-valuenow="2"
     aria-valuetext="Monday">
 </div>
</div>

The code snippet below shows a function that responds to user input and updates the aria-valuenow and aria-valuetext attributes:

var dayNames = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
var updateSlider = function (newValue) {
    var handle = document.getElementById("day-handle");
    handle.setAttribute("aria-valuenow", newValue.toString());
    handle.setAttribute("aria-valuetext", dayNames[newValue]);
};

• aria-valuemin
• aria-valuemax
• aria-valuenow
• aria-valuetext
• aria-orientation

TBD: Add support information for common UA and AT product combinations

• WAI-ARIA specification for the slider role