A switch allows users to select between one of two opposing states or options.
The switch component is made up of four elements.
- Helper text
Labels are not required if an adjacent label is included that adequately describes the purpose of the switch and is correctly referenced to the field for accessibility purposes.
Helper text can be included alongside the label to provide additional context or guidance for using the control.
When labels wrap to multiple lines, the first line of the text remains vertically centered with the control. Helper text simply wraps to the next line.
Switches can be either unselected or selected. Each of those statuses has five states:
The following component tokens are available for customizing the switch component.
Sample references including the swatch and computed values currently represent the applied light theme.
The token lists can be copied into tabular format for pasting into spreadsheets or other applications. Use these to help you document product-specific customizations or perform fine-grained filters.