Aller au contenu

Composants

Interrupteur

Active ou désactive un réglage qui s’applique immédiatement.

Utilisation

Basique

HTML
<bs:bsui-switch label="Email notifications" defaultChecked="true" />

Préférences

Les interrupteurs s’appliquent immédiatement : une liste de préférences n’a donc pas besoin de bouton d’enregistrement.

HTML
<bs:bsui-stack direction="column" gap="4">
  <bs:bsui-switch name="deploys" label="Deploy summaries" defaultChecked="true" />
  <bs:bsui-switch name="failures" label="Build failures" defaultChecked="true" />
  <bs:bsui-switch name="news" label="Product news" />
</bs:bsui-stack>

Lecture seule et désactivé

Un interrupteur en lecture seule affiche sa valeur sans pouvoir être basculé ; un interrupteur désactivé est aussi estompé.

HTML
<bs:bsui-stack direction="column" gap="4">
  <bs:bsui-switch label="Two factor authentication" defaultChecked="true" readOnly="true" />
  <bs:bsui-switch label="Single sign-on" disabled="true" />
</bs:bsui-stack>

Valeurs personnalisées

Les positions activée et désactivée peuvent envoyer n’importe quelle valeur, et pas seulement on et une valeur vide.

Submits weekly while it is on and never while it is off.
HTML
<bs:bsui-field>
  <bs:bsui-field-label text="Digest emails" />
  <bs:bsui-switch name="digest" label="Send a weekly digest" checkedValue="weekly" uncheckedValue="never" defaultChecked="true" />
  <bs:bsui-field-description text="Submits weekly while it is on and never while it is off." />
</bs:bsui-field>

Anatomie

Interrupteur est composé des blocs ci-dessous. Chacun est un bloc distinct qui ne s’affiche qu’à l’intérieur de son parent.

  • bsui/switch
  • bsui/switch-thumb

Attributs

AttributTypePar défaut
defaultChecked toggle false
disabled toggle false
readOnly toggle false
required toggle false
name text —
checkedValue text on
uncheckedValue text —
label richtext —
bindText text —
nameAlt text —
onChange text —
checked text —

bsui/switch-thumb

Ce bloc ne prend aucun attribut.