Saltar al contenido

Toggle

Interruptor on/off. A diferencia del Checkbox, representa un cambio que aplica de inmediato. Soporta estado de carga e íconos en el thumb.

Formularios · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Notificaciones activadas

html

Modo oscuro desactivado

html

Opción bloqueada por el plan

html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Tamaño

El tamaño del interruptor: sm, md o lg.

html

Variante

El color cuando está encendido: primary por defecto, que toma el primario del tema (primary; si no se define, la marca), o el semántico.

html

Estados

is-checked, is-disabled y is-loading: los estados del interruptor.

html

Combinaciones

Tamaño y color actuando juntos.

html

Cuándo usarlo

  • Un ajuste que se activa/desactiva y surte efecto al instante (una preferencia).
  • El estado on/off se entiende solo, sin necesidad de “guardar”.
  • Se busca reflejar que algo está pasando mientras aplica (estado de carga).

Cuándo no

  • El valor se confirma recién al enviar un formulario → checkbox.
  • Es una elección entre opciones, no un on/off → radio o segmented-control.

Cómo usarlo

  • Etiqueta que nombre el estado activado, no una acción.
  • Si aplicar tarda, se muestra el estado de carga en vez de mentir el resultado.

Cómo no usarlo

  • No se usa dentro de un formulario que se envía después → checkbox.
  • No se usa para tres o más estados: es binario.

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

Es un <input type="checkbox"> nativo con estilos de switch. Para pintar el estado, el Core refleja checked en la clase is-checked de la etiqueta y en el aria-checked del switch.

Qué hace: Al cambiar el interruptor, refleja checked en la clase is-checked de la etiqueta y, si el campo lleva role="switch", en su aria-checked, para que el estado se anuncie. El teclado, el foco y el envío son los del navegador.

Sin build, desde el CDN: taisho.toggle.css, además de taisho.base.css. También se carga:

  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

Implementa el patrón Switch de la WAI-ARIA APG.

  • Usa role="switch" con aria-checked.
  • En carga, se escriben juntos is-loading, aria-busy="true" y disabled: la clase sola sólo cambia el aspecto y no se anuncia.
  • El label se asocia al control y también actúa como área donde se puede hacer clic.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.