Aller au contenu

Composants

Sélectionner

Une liste déroulante pour choisir parmi plusieurs options.

Utilisation

Basique

HTML
<bs:bsui-select placeholder="Pick a region">
  <bs:bsui-select-trigger />
  <bs:bsui-select-popup>
    <bs:bsui-select-option value="eu" label="Europe" />
    <bs:bsui-select-option value="us" label="United States" />
    <bs:bsui-select-option value="ap" label="Asia Pacific" />
  </bs:bsui-select-popup>
</bs:bsui-select>

Sélection multiple

Plusieurs valeurs à la fois, affichées dans le déclencheur au fur et à mesure de leur sélection.

HTML
<bs:bsui-select multiple="true" name="stack" placeholder="Pick your stack">
  <bs:bsui-select-trigger />
  <bs:bsui-select-popup>
    <bs:bsui-select-option value="wordpress" label="WordPress" />
    <bs:bsui-select-option value="laravel" label="Laravel" />
    <bs:bsui-select-option value="astro" label="Astro" />
    <bs:bsui-select-option value="rails" label="Rails" />
  </bs:bsui-select-popup>
</bs:bsui-select>

Option indisponible

Le groupe envoie pro tant que personne ne le modifie ; enterprise est visible, mais ne peut pas être sélectionné.

HTML
<bs:bsui-select name="plan" defaultValue="pro" placeholder="Pick a plan">
  <bs:bsui-select-trigger />
  <bs:bsui-select-popup>
    <bs:bsui-select-option value="free" label="Free" />
    <bs:bsui-select-option value="pro" label="Pro" />
    <bs:bsui-select-option value="enterprise" label="Enterprise, contact sales" disabled="true" />
  </bs:bsui-select-popup>
</bs:bsui-select>

Dans un champ

Le message d’erreur est rattaché au champ, si bien que le menu déroulant lui-même reste inchangé.

Pick the region your data has to stay in.
HTML
<bs:bsui-field invalid="true">
  <bs:bsui-field-label text="Region" />
  <bs:bsui-select name="region" placeholder="Pick a region">
    <bs:bsui-select-trigger />
    <bs:bsui-select-popup>
      <bs:bsui-select-option value="eu" label="Europe" />
      <bs:bsui-select-option value="us" label="United States" />
    </bs:bsui-select-popup>
  </bs:bsui-select>
  <bs:bsui-field-error text="Pick the region your data has to stay in." />
</bs:bsui-field>

Anatomie

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

  • bsui/select
  • bsui/select-popup
  • bsui/select-option
  • bsui/select-trigger

Attributs

AttributTypePar défaut
defaultValue text —
multiple toggle false
name text —
placeholder text Select...
nameAlt text —
onChange text —
value text —
options text —

bsui/select-popup

Ce bloc ne prend aucun attribut.

bsui/select-option

AttributTypePar défaut
value text —
label text —
disabled toggle false

bsui/select-trigger

Ce bloc ne prend aucun attribut.