Skip to content

Description

Also known as a toggle switch or a toggle.

The Switch component (toggle) is a digital on/off switch. Toggle switches are best used for changing the state of system functionalities and preferences. "Toggles may replace two radio buttons or a single checkbox to allow users to choose between two opposing states." - Source

May may also check out the Checkbox component.

How it should work

"Toggle switches should take immediate effect and should not require the user to click Save or Submit to apply the new state. As always, we should strive to match the system to the real world." - Source

When not to use it

Don't use it if the user is required to click save or update to apply the new state.

Good practices

"The toggle labels should describe what the control will do when the switch is on; they should not be neutral or ambiguous. When in doubt, say the label aloud and append “on/off” to the end. If it doesn’t make sense, then rewrite the label" - Source

The label should describe what the toggle will do when the switch is on.

Demos

Unchecked Switch

Code Editor
<Switch
  label="Switch"
  on_change={({ checked }) => console.log(checked)}
/>

Checked Switch

Code Editor
<Switch
  label="Label"
  label_position="left"
  checked
  on_change={({ checked }) => console.log(checked)}
/>

Checked Switch with error message

Error message
Code Editor
<Switch label="Switch" checked status="Error message" />

Switch with suffix

Code Editor
<Switch
  label="Switch"
  checked
  suffix={<HelpButton title="Modal Title">Modal content</HelpButton>}
/>

Switch in different sizes

As for now, there are two sizes. medium is the default size.

Code Editor
<Switch size="medium" label="Medium" right="large" checked />
<Switch size="large" label="Large" right="large" checked />
<Switch size="large" label="Large" />

Switch in disabled state

Code Editor
<Switch checked disabled label="Disabled" />