Aller au contenu

Composants

Case à cocher

Un choix binaire qui prend aussi en charge un état indéterminé.

Utilisation

Basique

HTML
<bs:bsui-checkbox label="Email me about new releases" defaultChecked="true" />

Liste de cases à cocher

Chaque case envoie sa valeur sous son propre nom, et l’une d’elles ne peut pas être décochée.

HTML
<bs:bsui-stack direction="column" gap="3">
  <bs:bsui-checkbox name="deploys" label="A deploy finishes" defaultChecked="true" />
  <bs:bsui-checkbox name="failures" label="A build fails" defaultChecked="true" />
  <bs:bsui-checkbox name="mentions" label="Someone mentions me" />
  <bs:bsui-checkbox name="receipts" label="Billing receipts" defaultChecked="true" disabled="true" />
</bs:bsui-stack>

Indéterminé

La case parent indique une sélection partielle tant que tous les périmètres en dessous ne concordent pas.

HTML
<bs:bsui-stack direction="column" gap="3">
  <bs:bsui-checkbox label="All repository scopes" indeterminate="true" />
  <bs:bsui-checkbox name="read" label="Read code and issues" defaultChecked="true" />
  <bs:bsui-checkbox name="write" label="Push commits" />
</bs:bsui-stack>

État invalide

Comme tout autre contrôle, une case à cocher reçoit son message d’erreur depuis le champ.

Accept the terms to continue.
HTML
<bs:bsui-field invalid="true">
  <bs:bsui-checkbox name="terms" label="I agree to the terms of service" />
  <bs:bsui-field-error text="Accept the terms to continue." />
</bs:bsui-field>

Attributs

AttributTypePar défaut
defaultChecked toggle false
indeterminate toggle false
disabled toggle false
name text —
value text on
label richtext —
bindText text —
nameAlt text —
onChange text —
checked text —