Aller au contenu

Composants

Groupe de champs

Regroupe des champs associés sous un titre commun.

Utilisation

Basique

Billing Where invoices are sent.
HTML
<bs:bsui-field-group variant="card">
  <bs:bsui-field-group-title text="Billing" />
  <bs:bsui-field-group-description text="Where invoices are sent." />
  <bs:bsui-field-group-content>
    <bs:bsui-field>
      <bs:bsui-field-label text="Company" />
      <bs:bsui-input placeholder="Acme Inc." />
    </bs:bsui-field>
  </bs:bsui-field-group-content>
</bs:bsui-field-group>

Panneau de paramètres

Des contrôles variés dans une même carte, une présentation adaptée à la plupart des écrans de paramètres.

Notifications How this workspace reaches you.
Used on every automated email.
HTML
<bs:bsui-field-group variant="card">
  <bs:bsui-field-group-title text="Notifications" />
  <bs:bsui-field-group-description text="How this workspace reaches you." />
  <bs:bsui-field-group-content>
    <bs:bsui-field>
      <bs:bsui-field-label text="Reply-to address" />
      <bs:bsui-input type="email" name="replyTo" defaultValue="team@acme.com" />
      <bs:bsui-field-description text="Used on every automated email." />
    </bs:bsui-field>
    <bs:bsui-field>
      <bs:bsui-field-label text="Digest" />
      <bs:bsui-select name="digest" defaultValue="weekly" placeholder="Pick a cadence">
        <bs:bsui-select-trigger />
        <bs:bsui-select-popup>
          <bs:bsui-select-option value="daily" label="Every morning" />
          <bs:bsui-select-option value="weekly" label="Monday mornings" />
          <bs:bsui-select-option value="never" label="Never" />
        </bs:bsui-select-popup>
      </bs:bsui-select>
    </bs:bsui-field>
    <bs:bsui-field>
      <bs:bsui-switch name="failures" label="Alert me when a build fails" defaultChecked="true" />
    </bs:bsui-field>
    <bs:bsui-field>
      <bs:bsui-checkbox name="marketing" label="Send product news once a month" />
    </bs:bsui-field>
  </bs:bsui-field-group-content>
</bs:bsui-field-group>

Sections

La variante par défaut supprime la carte, ce qui convient à une longue page composée de sections empilées.

Profile Shown on comments and pull requests.
Billing Where invoices are sent.
HTML
<bs:bsui-stack direction="column" gap="6" align="stretch">
  <bs:bsui-field-group>
    <bs:bsui-field-group-title text="Profile" />
    <bs:bsui-field-group-description text="Shown on comments and pull requests." />
    <bs:bsui-field-group-content>
      <bs:bsui-field>
        <bs:bsui-field-label text="Display name" />
        <bs:bsui-input defaultValue="Ada Lovelace" />
      </bs:bsui-field>
    </bs:bsui-field-group-content>
  </bs:bsui-field-group>
  <bs:bsui-field-group>
    <bs:bsui-field-group-title text="Billing" />
    <bs:bsui-field-group-description text="Where invoices are sent." />
    <bs:bsui-field-group-content>
      <bs:bsui-field>
        <bs:bsui-field-label text="Company" />
        <bs:bsui-input defaultValue="Acme Inc." />
      </bs:bsui-field>
      <bs:bsui-field>
        <bs:bsui-field-label text="VAT ID" />
        <bs:bsui-input placeholder="DE123456789" />
      </bs:bsui-field>
    </bs:bsui-field-group-content>
  </bs:bsui-field-group>
</bs:bsui-stack>

Groupe désactivé

Un groupe désactivé est un fieldset désactivé : tous les contrôles qu’il contient cessent de répondre.

Custom domain Available on the Team plan.
HTML
<bs:bsui-field-group variant="card" disabled="true">
  <bs:bsui-field-group-title text="Custom domain" />
  <bs:bsui-field-group-description text="Available on the Team plan." />
  <bs:bsui-field-group-content>
    <bs:bsui-field>
      <bs:bsui-field-label text="Domain" />
      <bs:bsui-input placeholder="app.acme.com" />
    </bs:bsui-field>
    <bs:bsui-field>
      <bs:bsui-switch label="Redirect the default domain" />
    </bs:bsui-field>
  </bs:bsui-field-group-content>
</bs:bsui-field-group>

Anatomie

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

  • bsui/field-group
  • bsui/field-group-content
  • bsui/field-group-description
  • bsui/field-group-title

Attributs

AttributTypePar défaut
variant default card default
disabled toggle false

bsui/field-group-content

Ce bloc ne prend aucun attribut.

bsui/field-group-description

AttributTypePar défaut
text richtext —

bsui/field-group-title

AttributTypePar défaut
text richtext —