Przejdź do treści

Komponenty

Przełącznik

Przełącza ustawienie, które zaczyna obowiązywać od razu.

Użycie

Podstawowy

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

Preferencje

Przełączniki wprowadzają zmiany od razu, więc lista nie wymaga przycisku zapisywania.

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>

Tylko do odczytu i wyłączone

Przełącznik tylko do odczytu nadal pokazuje swoją wartość, ale nie pozwala jej zmienić. Wyłączony dodatkowo wygląda na przygaszony.

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>

Własne wartości

Pozycje włączona i wyłączona mogą przesyłać dowolne wartości, a nie tylko on i pustą wartość.

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>

Budowa

Przełącznik składa się z poniższych bloków. Każdy z nich jest osobnym blokiem, który renderuje się tylko wewnątrz swojego elementu nadrzędnego.

  • bsui/switch
  • bsui/switch-thumb

Atrybuty

AtrybutTypDomyślnie
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

Ten blok nie przyjmuje atrybutów.