Switch Example
This example illustrates implementation of the switch design pattern for a notification preferences control.
It uses a div
element for the switch and CSS borders to provide graphical rendering of switch states.
Similar examples include:
- Switch Example Using HTML Button: A group of 2 switches based on HTML
button
elements that turn lights on and off. - Switch Example Using HTML Checkbox Input: A group of 2 switches based on HTML
input[type="checkbox"]
elements that turn accessibility preferences on and off.
Example
Notifications
Accessibility Features
-
To make understanding the state of the switch easier for users with visual or cognitive disabilities, a text equivalent of the state (
on
oroff
) is displayed adjacent to the graphical state indicator. CSS attribute selectors ensure the label displayed is synchronized with the value of thearia-checked
attribute.
NOTE: To prevent redundant announcement of the state by screen readers, the text indicators of state are hidden from assistive technologies witharia-hidden
. - Spacing, border widths and fill are important to ensure the graphical states are visible and discernible to people with visual impairments, including when browser or operating system high contrast settings are enabled:
- To make the graphical representation of the state of a switch readily perceivable, two pixel borders are used for the switch state container and a solid color is used for the fill of the circles indicating the on and off states.
- To ensure users can perceive the difference between the container and the circles used to indicate the state of the switch, there are two pixels of space between the container border and the circles.
- To enhance perceivability when operating the switches, visual keyboard focus and hover are styled using the CSS
:hover
and:focus
pseudo-classes:- To make it easier to perceive focus and the relationship between a label and its associated switch, focus creates a border around both the switch and the label and also changes the background color.
- To make it easier to perceive that clicking either the label or switch will activate the switch, the hover indicator is the same as the focus indicator.
- To help people with visual impairments identify the switch as an interactive element, the cursor is changed to a pointer when hovering over the switch.
- Note: Because transparent borders are visible on some systems with operating system high contrast settings enabled, transparency cannot be used to create a visual difference between the element that is focused an other elements. Instead of using transparency, the focused element has a thicker border and less padding. When an element receives focus, its border changes from zero to two pixels and padding is reduced by two pixels. When an element loses focus, its border changes from two pixels to two and padding is increased by two pixels.
Keyboard Support
Key | Function |
---|---|
Tab |
|
Space Enter |
|
Role, Property, State, and Tabindex Attributes
Role | Attribute | Element | Usage |
---|---|---|---|
switch |
div |
Identifies the div element as a switch . |
|
tabindex="0" |
div |
Includes the switch in the page Tab sequence. | |
aria-checked="false" |
div |
|
|
aria-checked="true" |
div |
|
|
aria-hidden="true" |
span.on and span.off |
|
Javascript and CSS Source Code
- CSS: switch.css
- Javascript: switch.js
HTML Source Code