Saltar al contenido

Checkbox

Casilla booleana. Soporta estado indeterminado, descripción (ts checkbox-description), modo tarjeta (is-card), error (is-invalid) y agrupación con ts checkbox-group, que incluye “seleccionar todo” (data-ts-select-all).

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.

Marcado

html

Sin marcar

html

«Seleccionar todo» con selección parcial

html

Deshabilitado

html

Con descripción

html

Elegir entorno en tarjetas: marcado

html

Elegir entorno en tarjetas: sin marcar

html

Con error

html

Con ayuda

html

Grupo de notificaciones con error

Notificaciones
html

Referencia de clases

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

Tamaño

El tamaño de la casilla: sm, md o lg.

html

Variante

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

html

Densidad

El aire alrededor de la casilla y su etiqueta.

html

Estados

is-checked, is-indeterminate y is-disabled: los estados de la casilla.

html

Combinaciones

Tamaño y color actuando juntos.

html

Cuándo usarlo

  • Una opción de sí/no que se confirma al enviar el formulario (términos, un flag).
  • Elegir varias de una lista, dentro de un ts checkbox-group.
  • Hace falta el estado indeterminado (un “seleccionar todo” parcial).
  • Hay que mostrar un error o una ayuda pegada a la casilla, suelta o dentro del HTML de field.

Cuándo no

  • El cambio aplica de inmediato, no al enviar → toggle.
  • Es elegir una sola de varias → radio.

Cómo usarlo

  • Etiqueta clara en positivo: que marcar signifique lo que dice.
  • Para varias relacionadas, se agrupan con ts checkbox-group.
  • Si la etiqueta sola no alcanza para decidir, se suma una descripción (has-description); el modo is-card sirve cuando cada opción es una tarjeta (un plan, un canal).
  • Un error de grupo (Elegir al menos un canal.) va una vez en el grupo, no repetido en cada casilla.

Cómo no usarlo

  • No se usa para un ajuste que surte efecto en el acto → toggle.
  • No se arma un grupo donde sólo una puede estar marcada → radio.
  • No se usa is-card para una casilla suelta de aceptar términos: la tarjeta es para elegir entre opciones.

Relacionados

ToggleRadioField

TaishoDS Core

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

Es un <input type="checkbox"> nativo: foco, teclado y envío de formularios los resuelve el navegador. Para pintar el estado, el Core refleja checked en la clase is-checked de la etiqueta; el error, la ayuda y la descripción son marcado que ya trae el ejemplo.

Qué hace: Un grupo (ts checkbox-group) con casilla «seleccionar todo» (data-ts-select-all en la casilla maestra): marca o desmarca todas las demás y queda mixta (indeterminate) si hay algunas marcadas.

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

  • taisho.icon.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

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

  • Se apoya en un <input type="checkbox"> nativo (foco, teclado y estados accesibles de fábrica).
  • El estado mixto (indeterminado) se refleja en la propiedad DOM real del <input>, no solo visualmente.
  • Un grupo de casillas va en un contenedor con role="group" y nombre accesible (aria-label, o aria-labelledby al texto visible del grupo).
  • El texto de ayuda y el mensaje de error se enlazan al <input> por aria-describedby; el estado inválido marca aria-invalid="true" y el error se anuncia (aria-live="polite"). En un grupo, el estado inválido lo lleva cada casilla (role="group" no admite aria-invalid) y el mensaje describe al grupo.
  • La descripción de la casilla queda dentro del <label>, así que forma parte de su nombre accesible.

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.