Zum Inhalt springen

Komponenten

Feld

Umschließt ein Steuerelement mit Beschriftung, Beschreibung und Fehlermeldung.

Verwendung

Einfach

We only use this for receipts.
HTML
<bs:bsui-field>
  <bs:bsui-field-label text="Email address" />
  <bs:bsui-input type="email" placeholder="you@example.com" />
  <bs:bsui-field-description text="We only use this for receipts." />
</bs:bsui-field>

Ungültiger Zustand

Wird das Feld als ungültig markiert, ändert sich die Farbe des Steuerelements und die Meldung erscheint darunter.

Enter an address with a domain, like ada@example.com.
HTML
<bs:bsui-field invalid="true">
  <bs:bsui-field-label text="Work email" />
  <bs:bsui-input type="email" defaultValue="ada@example" />
  <bs:bsui-field-error text="Enter an address with a domain, like ada@example.com." />
</bs:bsui-field>

Erforderlich

Im Hilfetext steht die Anforderung genau erklärt, deshalb bleibt die Beschriftung kurz.

Required. This name appears on every invoice.
HTML
<bs:bsui-field>
  <bs:bsui-field-label text="Workspace name" />
  <bs:bsui-input placeholder="Acme Production" required="true" />
  <bs:bsui-field-description text="Required. This name appears on every invoice." />
</bs:bsui-field>

Deaktiviert

Deaktiviere das Feld und das darin enthaltene Steuerelement, damit die ganze Zeile gesperrt wirkt.

The URL is fixed once the workspace is created.
HTML
<bs:bsui-field disabled="true">
  <bs:bsui-field-label text="Workspace URL" />
  <bs:bsui-input defaultValue="acme.blockstudio.dev" disabled="true" />
  <bs:bsui-field-description text="The URL is fixed once the workspace is created." />
</bs:bsui-field>

Auswahlfeld

Ein Feld umschließt gruppierte Steuerelemente genauso wie ein einzelnes Eingabefeld.

Pick a target before deploying.
HTML
<bs:bsui-field invalid="true">
  <bs:bsui-field-label text="Deploy target" />
  <bs:bsui-radio-group orientation="horizontal">
    <bs:bsui-radio value="staging" label="Staging" />
    <bs:bsui-radio value="production" label="Production" />
  </bs:bsui-radio-group>
  <bs:bsui-field-error text="Pick a target before deploying." />
</bs:bsui-field>

Aufbau

Feld besteht aus den folgenden Blöcken. Jeder davon ist ein eigener Block, der nur innerhalb seines übergeordneten Blocks gerendert wird.

  • bsui/field
  • bsui/field-description
  • bsui/field-error
  • bsui/field-label

Attribute

AttributTypStandard
name text —
invalid toggle false
disabled toggle false

bsui/field-description

AttributTypStandard
text richtext —

bsui/field-error

AttributTypStandard
text richtext —

bsui/field-label

AttributTypStandard
text richtext —