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
Modo oscuro desactivado
Opción bloqueada por el plan
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.
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.
Estados
is-checked, is-disabled y is-loading: los estados del interruptor.
Combinaciones
Tamaño y color actuando juntos.
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 →
radioosegmented-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.
Relacionados
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"conaria-checked. - En carga, se escriben juntos
is-loading,aria-busy="true"ydisabled: la clase sola sólo cambia el aspecto y no se anuncia. - El
labelse 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.