Saltar al contenido

Componentes

Interruptor

Activa o desactiva un ajuste que se aplica de inmediato.

Uso

Básica

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

Preferencias

Los interruptores se aplican de inmediato, así que una lista de ellos no necesita un botón para guardar.

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>

Solo lectura y desactivado

Un interruptor de solo lectura muestra su valor, pero no permite cambiarlo; uno desactivado también aparece atenuado.

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>

Valores personalizados

Las posiciones de activado y desactivado pueden enviar cualquier valor, no solo on y vacío.

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>

Estructura

Interruptor se compone de los bloques siguientes. Cada uno es un bloque independiente que solo se representa dentro de su elemento principal.

  • bsui/switch
  • bsui/switch-thumb

Atributos

AtributoTipoPredeterminado
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

Este bloque no admite atributos.