Saltar al contenido

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»

Nuevo
html

Estado de un despliegue: listo

Listo
html

Estado de un despliegue: en cola, con punto

En cola
html

Estado de un despliegue: falló, relleno sólido

Falló
html

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.

Producción Producción Producción
html

Relleno

Qué tan sólido es el fondo: solid pinta el color entero, subtle lo atenúa.

Listo Listo
html

Variante

El color semántico, según lo que comunica: success, warning, info, danger, brand, accent…

Estado Estado Estado Estado Estado Estado Estado Estado
html

Contraste

contrast-low baja el contraste cuando la etiqueta acompaña y no tiene que gritar.

Info Info
html

Densidad

El aire interno: compact aprieta el padding, comfortable lo afloja.

Aviso Aviso
html

Estados

is-pulse agrega un latido para señales en vivo.

Listo En vivo
html

Combinaciones

Tamaño, fill y color actuando juntos.

Deploy Deploy Deploy
html

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.

Relacionados

TagNoteButton

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. Con prefers-reduced-motion el 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.