Saltar al contenido

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

diseño accesibilidad
html

Etiqueta fija

sin descartar
html

Etiqueta clicable

Producción
html

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.

Producción Producción Producción
html

Forma

default o pill (totalmente redondeado).

Staging Staging
html

Variante

El color semántico: default, success, warning, info o danger.

Despliegue Despliegue Despliegue Despliegue Despliegue
html

Densidad

El aire interno: compact o comfortable.

Despliegue Despliegue
html

Estados

is-clickable cuando el tag dispara una acción.

Editor Lector
html

Combinaciones

Tamaño, forma y color actuando juntos.

Rollback Rollback
html

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.

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-dismiss
  • data-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.css
  • taisho.icon.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Un tag is-clickable es operable por teclado (Enter/Espacio).
  • El botón de cierre (data-ts-dismiss) tiene aria-label propio.

Teclado

Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).

Tecla Qué hace
Enter/EspacioActiva 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.