JSPM

@material/switch

0.33.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 563459
  • Score
    100M100P100Q178321F
  • License Apache-2.0

The Material Components for the web switch component

Package Exports

  • @material/switch/dist/mdc.switch.css
  • @material/switch/dist/mdc.switch.min.css
  • @material/switch/mdc-switch.scss

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@material/switch) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Switches

The MDC Switch component is a spec-aligned switch component adhering to the Material Design Switch requirements. It works without JavaScript.

Design & API Documentation

Installation

npm install --save @material/switch

Usage

HTML Structure

<div class="mdc-switch">
  <input type="checkbox" id="basic-switch" class="mdc-switch__native-control" />
  <div class="mdc-switch__background">
    <div class="mdc-switch__knob"></div>
  </div>
</div>
<label for="basic-switch">off/on</label>

Disabled Switch

Users can add disabled directly to the input element or set the fieldset containing the switch to disabled to disable a switch. Disabled switches cannot be interacted with and have no visual interaction effect.

<div class="mdc-switch">
  <input type="checkbox" id="another-basic-switch" class="mdc-switch__native-control" disabled />
  <div class="mdc-switch__background">
    <div class="mdc-switch__knob"></div>
  </div>
</div>
<label for="another-basic-switch">off/on</label>

CSS Classes

CSS Class Description
mdc-switch Mandatory, for the parent element
mdc-switch__native-control Mandatory, for the input checkbox
mdc-switch__background Mandatory, for the background element
mdc-switch__knob Mandatory, for the knob element

Sass Mixins

The following mixins apply only to enabled switches in the on (checked) state. It is not currently possible to customize the color of a disabled or off (unchecked) switch.

Mixin Description
mdc-switch-track-color($color) Sets the track color
mdc-switch-knob-color($color) Sets the knob color
mdc-switch-focus-indicator-color($color) Sets the focus indicator color