Slide toggle

Overview for slide-toggle

<mat-slide-toggle> is an on/off control that can be toggled via clicking or dragging.

Basic slide-toggles

The slide-toggle behaves similarly to a checkbox, though it does not support an indeterminate state like <mat-checkbox>.

Note: the sliding behavior for this component requires that HammerJS is loaded on the page.

The slide-toggle label is provided as the content to the <mat-slide-toggle> element.

If you don't want the label to appear next to the slide-toggle, you can use aria-label or aria-labelledby to specify an appropriate label.

<mat-slide-toggle> is compatible with @angular/forms and supports both FormsModule and ReactiveFormsModule.

The color of a <mat-slide-toggle> can be changed by using the color property. By default, slide-toggles use the theme's accent color. This can be changed to 'primary' or 'warn'.

The <mat-slide-toggle> uses an internal <input type="checkbox"> to provide an accessible experience. This internal checkbox receives focus and is automatically labelled by the text content of the <mat-slide-toggle> element.

Slide toggles without text or labels should be given a meaningful label via aria-label or aria-labelledby.