Badge
Etiqueta compacta para estados, categorías o conteos. Tiene relleno sutil o sólido (fill-subtle, fill-solid), punto de estado con pulso opcional (data-badge-dot, is-pulse), ícono antes o después (ts badge-prefix, ts badge-suffix), y puede ser un enlace: <a class="ts badge" href>.
Avisos y estado · 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.
Etiqueta «Nuevo»
Estado de un despliegue: listo
Estado de un despliegue: en cola, con punto
Estado de un despliegue: falló, relleno sólido
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Tamaño
El alto de la etiqueta: sm para listas densas, lg para destacar.
Relleno
Qué tan sólido es el fondo: solid pinta el color entero, subtle lo atenúa.
Variante
El color semántico, según lo que comunica: success, warning, info, danger, brand, accent…
Contraste
contrast-low baja el contraste cuando la etiqueta acompaña y no tiene que gritar.
Densidad
El aire interno: compact aprieta el padding, comfortable lo afloja.
Estados
is-pulse agrega un latido para señales en vivo.
Combinaciones
Tamaño, fill y color actuando juntos.
Cuándo usarlo
- Mostrar el estado de algo en una palabra: “Activo”, “Beta”, “Vencido”.
- Poner un conteo o una categoría al lado de un título o una fila.
- Se busca que se lea de un vistazo, sin que sea un control.
Cuándo no
- El usuario tiene que poder quitarlo o tocarlo para filtrar →
tag. - El mensaje necesita más de dos palabras →
note. - Es una acción, no una etiqueta →
button.
Cómo usarlo
- El texto tiene que decir el estado: el color solo no alcanza.
- El punto refuerza un estado en vivo, nunca reemplaza la etiqueta.
Cómo no usarlo
- No se usa de botón: si hay que hacer clic, es otra cosa.
- No se meten frases: un badge largo deja de ser compacto.
TaishoDS Core
No necesita JavaScript: es marcado y CSS.
Presentacional puro.
Sin build, desde el CDN: taisho.badge.css, además de taisho.base.css. Con ese archivo alcanza.
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- El significado va en el texto, no solo en el color: un badge de estado siempre debe llevar una etiqueta legible.
- El punto (
ts badge-dot) y el latido (is-pulse) son decorativos; no reemplazan a la etiqueta de texto. Conprefers-reduced-motionel halo del pulso se detiene y queda el punto.
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.