Tag
Etiqueta para clasificar o filtrar contenido — categorías, filtros aplicados, keywords. A diferencia del Badge, está pensada para ser interactiva: clicable (is-clickable) y/o descartable (data-ts-dismissible), con prefijo, tamaños y formas.
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.
Etiquetas descartables
Etiqueta fija
Etiqueta clicable
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Tamaño
El tamaño del tag: sm, md o lg.
Forma
default o pill (totalmente redondeado).
Variante
El color semántico: default, success, warning, info o danger.
Densidad
El aire interno: compact o comfortable.
Estados
is-clickable cuando el tag dispara una acción.
Combinaciones
Tamaño, forma y color actuando juntos.
Cuándo usarlo
- Representar filtros aplicados que el usuario puede quitar uno por uno.
- Listar keywords o categorías en las que se puede hacer clic para navegar o filtrar.
- El usuario agrega y saca ítems de un conjunto.
Cuándo no
- Es sólo informativo y nadie lo va a tocar →
badge. - Es una acción principal de la pantalla →
button. - Es una elección entre pocas opciones excluyentes →
segmented-control.
Cómo usarlo
- Si es descartable, que quitarlo tenga un efecto visible inmediato.
- Los textos se mantienen cortos: los tags se leen en grupo, no de a uno.
Cómo no usarlo
- Un tag que no lleva a ningún lado no se hace clicable: promete algo que no cumple.
- No se mezclan tags interactivos con etiquetas informativas en la misma fila → para esas se usa
badge.
Relacionados
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Es descartable y responde al teclado.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-dismissdata-ts-dismissible
Qué hace: Quita el tag con clic o Backspace y avisa al contenedor. Un tag is-clickable también responde a Enter y Espacio, con el mismo click de un botón.
Sin build, desde el CDN: taisho.tag.css, además de taisho.base.css. También se carga:
taisho.button.csstaisho.icon.csstaisho.spinner.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- Un tag
is-clickablees operable por teclado (Enter/Espacio). - El botón de cierre (
data-ts-dismiss) tienearia-labelpropio.
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| Enter/Espacio | Activa el botón de quitar, cuando el tag es removible. |
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 Mapa de teclas documentado arriba, contrastado contra el componente.
- 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.