Toggle

Toggle

Toggle turns a native checkbox into an on/off switch. Add role="switch" so assistive tech announces it as a switch, and always label it.

Class names

Class nameTypeDescription
toggleComponentSwitch on a checkbox input; pair with role="switch"
toggle-primaryColorPrimary color when on (default)
toggle-secondaryColorSecondary color when on
toggle-successColorSuccess color when on
toggle-warningColorWarning color when on
toggle-infoColorInfo color when on
toggle-dangerColorDanger color when on
toggle-smSizeSmall
toggle-lgSizeLarge

Toggle

<label class="label-inline" for="toggle-ex1">
  <input type="checkbox" role="switch" class="toggle" id="toggle-ex1"> Notifications
</label>

Colors

<label class="label-inline" for="toggle-ex2-primary">
  <input type="checkbox" role="switch" class="toggle toggle-primary" id="toggle-ex2-primary" checked> Primary
</label>
<label class="label-inline" for="toggle-ex2-secondary">
  <input type="checkbox" role="switch" class="toggle toggle-secondary" id="toggle-ex2-secondary" checked> Secondary
</label>
<label class="label-inline" for="toggle-ex2-success">
  <input type="checkbox" role="switch" class="toggle toggle-success" id="toggle-ex2-success" checked> Success
</label>
<label class="label-inline" for="toggle-ex2-warning">
  <input type="checkbox" role="switch" class="toggle toggle-warning" id="toggle-ex2-warning" checked> Warning
</label>
<label class="label-inline" for="toggle-ex2-info">
  <input type="checkbox" role="switch" class="toggle toggle-info" id="toggle-ex2-info" checked> Info
</label>
<label class="label-inline" for="toggle-ex2-danger">
  <input type="checkbox" role="switch" class="toggle toggle-danger" id="toggle-ex2-danger" checked> Danger
</label>

Sizes

Medium is the default; there is no toggle-md class.

<label class="label-inline" for="toggle-ex3-sm">
  <input type="checkbox" role="switch" class="toggle toggle-sm" id="toggle-ex3-sm" checked> Small
</label>
<label class="label-inline" for="toggle-ex3-md">
  <input type="checkbox" role="switch" class="toggle" id="toggle-ex3-md" checked> Medium
</label>
<label class="label-inline" for="toggle-ex3-lg">
  <input type="checkbox" role="switch" class="toggle toggle-lg" id="toggle-ex3-lg" checked> Large
</label>

Checked

Use the checked attribute to start in the on position.

<label class="label-inline" for="toggle-ex4">
  <input type="checkbox" role="switch" class="toggle" id="toggle-ex4" checked> Wi-Fi
</label>

Disabled

<label class="label-inline" for="toggle-ex5-off">
  <input type="checkbox" role="switch" class="toggle" id="toggle-ex5-off" disabled> Offline
</label>
<label class="label-inline" for="toggle-ex5-on">
  <input type="checkbox" role="switch" class="toggle" id="toggle-ex5-on" checked disabled> Locked on
</label>

Settings list

Preferences

<fieldset>
  <legend>Preferences</legend>
  <label class="label-inline" for="toggle-ex6-sync">
    <input type="checkbox" role="switch" class="toggle toggle-success" id="toggle-ex6-sync" checked> Sync across devices
  </label>
  <br>
  <label class="label-inline" for="toggle-ex6-beta">
    <input type="checkbox" role="switch" class="toggle toggle-warning" id="toggle-ex6-beta"> Beta features
  </label>
  <br>
  <label class="label-inline" for="toggle-ex6-analytics">
    <input type="checkbox" role="switch" class="toggle toggle-info" id="toggle-ex6-analytics"> Share usage analytics
  </label>
</fieldset>