Checkbox
Los Checkbox son herramientas interactivas que permiten a los usuarios elegir entre ninguna, una o varias opciones de una lista, según sus preferencias o necesidades. Cada casilla es independiente: marcar una no desmarca a las demás.
Previsualización Rápida
Section titled “Previsualización Rápida”Probá hacer clic sobre la casilla o sobre el texto: ambos activan la selección.
Propósito
Section titled “Propósito”El Checkbox permite tomar decisiones independientes y reversibles dentro de un formulario o una configuración. A diferencia de un Switch, la elección no se aplica en el momento: queda registrada y se confirma recién cuando el usuario envía el formulario o presiona la acción principal del flujo.
Anatomía del Componente
Section titled “Anatomía del Componente”Text Error
- Átomo de Checkbox: La casilla cuadrada de 20 × 20 px con radio pequeño. Es el único elemento que cambia de apariencia al seleccionarse (fondo primario + tilde blanco).
- TextGroup (Label): Texto principal que describe la opción. Es obligatorio y también funciona como área de clic.
- TextGroup → Description (booleano): Texto secundario en gris para aclarar o ampliar la opción. Se activa o desactiva según la necesidad.
- ActionIcon (booleano): Ícono accionable a la derecha, pensado para abrir información adicional (un tooltip, un modal o un detalle). Es independiente de la casilla: tocarlo no marca ni desmarca la opción.
- ErrorMessage (booleano): Mensaje de validación con ícono de alerta, alineado al texto. Solo aparece cuando el Checkbox entra en estado de error.
Estados de Interacción
Section titled “Estados de Interacción”- Default: Casilla blanca con borde gris. Invita a la acción sin competir con el contenido.
- Hover: Al pasar el cursor por la casilla o por el texto, el borde toma el color primario y aparece un halo suave que confirma que el elemento es interactivo.
- Focus: Al navegar con teclado se muestra un contorno azul alrededor de la casilla. Nunca debe ocultarse.
- Active (presionado): La casilla se contrae levemente al presionarla, dando respuesta táctil inmediata.
- Seleccionado (checked): Fondo primario con tilde blanco. Es el único estado que comunica una elección confirmada.
- Indeterminado: Fondo primario con un guion. Se usa solo en un checkbox “padre” que controla una lista, cuando algunas opciones hijas están marcadas y otras no.
- Error: El borde pasa a rojo y se enciende el ErrorMessage. Se usa cuando una casilla obligatoria no fue marcada al intentar avanzar.
- Deshabilitado: Casilla y textos en gris claro, sin respuesta al cursor. El usuario puede leer la opción pero no modificarla.
Usos Recomendados y Guía de UX
Section titled “Usos Recomendados y Guía de UX”Cuándo usar
Section titled “Cuándo usar”- Para ofrecer a los usuarios una variedad de opciones que puedan seleccionar en un formulario (filtros, preferencias, permisos).
- Para permitir que los usuarios confirmen su aceptación de una política, servicio o conjunto de términos y condiciones.
- Cuando la elección de una opción no depende de las demás y el usuario puede elegir varias al mismo tiempo, o ninguna.
- Cuando la decisión se confirma recién al enviar el formulario.
Cuándo NO usar
Section titled “Cuándo NO usar”- Una sola opción entre varias mutuamente excluyentes: usá un Radio. Si solo puede haber una respuesta, el Checkbox genera confusión.
- Activar o desactivar algo de forma inmediata (notificaciones, modo oscuro, biometría): usá un Switch, que aplica el cambio en el momento.
- Disparar una acción (enviar, confirmar, eliminar): usá un Button. Marcar una casilla nunca debe ejecutar un proceso por sí solo.
- Listas muy largas de opciones (más de 8 a 10): considerá un selector con búsqueda o un Multiselect para no saturar la pantalla.
Manejo de errores
Section titled “Manejo de errores”- Checkbox individual: cuando una (1) casilla entra en error, su ErrorMessage se activa debajo del texto.
- Dentro de un Checkbox.Group: las casillas se marcan en rojo y el mensaje de error se muestra una sola vez, al final del grupo (booleano del grupo), no repetido en cada opción.
- El error aparece al intentar avanzar, no mientras el usuario todavía está completando el formulario. Desaparece en cuanto la condición se cumple.
Variantes / Opciones
Section titled “Variantes / Opciones”Checkbox con Description y ActionIcon
Section titled “Checkbox con Description y ActionIcon”La Description y el ActionIcon son elementos opcionales que se encienden según la complejidad de la opción. Usá la Description para aclarar consecuencias o condiciones; usá el ActionIcon cuando la explicación sea demasiado extensa para una línea.
Checkbox.Card
Section titled “Checkbox.Card”Es el mismo componente dentro de una caja. Toda la superficie de la tarjeta es accionable y tiene su propio estado de hover. Al seleccionarse, la tarjeta toma borde primario y un fondo suave, lo que refuerza la elección cuando las opciones tienen más peso visual.
- Cuándo usarlo: para elegir productos, planes o servicios donde cada opción necesita más contexto o jerarquía visual.
- Cuándo evitarlo: en formularios densos o listas de preferencias simples; ahí el Checkbox estándar es más liviano.
- El ActionIcon se mantiene independiente también dentro de la tarjeta: tocarlo no altera la selección.
TérminosYCondiciones
Section titled “TérminosYCondiciones”Checkbox preconfigurado para aceptar términos, políticas o condiciones del servicio. El texto se lee como una sola frase con el enlace integrado: “Acepto los Términos y condiciones”. Todos los campos se pueden personalizar (texto de aceptación, texto del enlace, texto posterior, destino y mensaje de error).
Debe aceptar Términos y Condiciones
- Una sola frase: el enlace forma parte de la oración. Así el usuario entiende qué está aceptando de un vistazo, y el lector de pantalla anuncia la casilla como “Acepto los Términos y condiciones”, no solo “Aceptar”.
- Verbo en primera persona: “Acepto”, “Leí y acepto”. La casilla marcada representa lo que el usuario afirma.
- El enlace abre el documento sin marcar la casilla; aceptar siempre es una acción explícita del usuario.
- Obligatorio: si el usuario intenta avanzar sin aceptarlo, se muestra el mensaje “Debe aceptar Términos y Condiciones”.
- Nunca lo muestres marcado por defecto: la aceptación debe ser una decisión consciente.
- Textos largos: si la frase ocupa más de una línea, el texto continúa alineado a la derecha de la casilla, nunca debajo de ella.
Checkbox.Group
Section titled “Checkbox.Group”Agrupa varios Checkbox bajo un Label y una Description comunes. En Figma es un componente detachable: una vez que lo detachás podés agregar las instancias que necesites.
Puede usarse agrupado de dos formas:
- Vertical: no tiene límite de opciones. Es la opción recomendada por defecto porque facilita la lectura.
- Horizontal: en mobile se pueden usar como máximo 2 opciones por fila y en desktop como máximo 4. Reservala para opciones con textos cortos.
Vertical
Section titled “Vertical”Horizontal
Section titled “Horizontal”Achicá la ventana para ver cómo el grupo horizontal pasa de 4 a 2 opciones por fila en mobile.
Grupo en error
Section titled “Grupo en error”Espaciados
Section titled “Espaciados”| Medida | Valor | Uso |
|---|---|---|
| checkbox/gap | 16 px | Separación entre el encabezado del grupo (Label + Description) y las opciones. |
| checkbox/group-options (vertical) | 8 px | Separación entre opciones apiladas. |
| checkbox/group-options (horizontal) | 16 px | Separación entre opciones en fila. |
Accesibilidad
Section titled “Accesibilidad”Semántica
Section titled “Semántica”- Es un elemento semántico: se renderiza como una casilla de verificación nativa del navegador.
- Soporta el estado deshabilitado nativo para evitar la interacción cuando sea necesario.
- El label está asociado a la casilla, por lo que hacer clic en el texto también la activa y el lector de pantalla lo anuncia como su nombre.
- El Checkbox.Group se anuncia como un grupo: el lector lee su Label antes de recorrer las opciones.
Navegación por teclado
Section titled “Navegación por teclado”- Mantiene el foco visible en la navegación por teclado.
- Tab para navegar entre casillas y hacia el ActionIcon o el enlace de términos.
- Espacio para activar o desactivar la casilla que tiene el foco.
Lector de pantalla
Section titled “Lector de pantalla”- Anuncia el rol automáticamente (“casilla de verificación”).
- Informa el estado: marcada, no marcada o mixta (indeterminada).
- El estado deshabilitado es leído por el lector de pantalla.
- La Description y el ErrorMessage se leen junto con la casilla, de modo que la persona conoce el contexto y el error sin tener que buscarlos.
- El ActionIcon siempre tiene un nombre accesible que explica qué información abre.
ChangeLog
Section titled “ChangeLog”Consultá el historial de cambios de todos los componentes de este Design System en la Sheet de ChangeLog.