Banner
Mensaje de ancho completo para un estado global de la página o la app. Lleva ícono semántico según la variante, acciones opcionales, y puede ser descartable (data-ts-dismissible) o quedar fijo arriba (is-sticky).
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.
Aviso de plan descartable
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Variante
El color según el tono del aviso: default, success, warning, info o danger.
Estados
is-sticky fija el banner arriba mientras se scrollea.
Cuándo usarlo
- El mensaje afecta a toda la página o a toda la app: una caída, un plan vencido, un modo de mantenimiento.
- Tiene que verse sí o sí al entrar, sin que el usuario lo busque.
- Puede llevar una acción para resolverlo ahí mismo (reintentar, actualizar el plan).
Cuándo no
- El aviso es sobre una parte del contenido y no sobre la página entera →
note. - Es la confirmación de algo que el usuario acaba de hacer, y puede irse solo →
toast. - Es el error de un campo de formulario → el
errordelfield.
Cómo usarlo
- Un banner por vez: si hay dos compitiendo, ninguno se lee.
- La salida va en el propio banner: qué pasó y qué hacer al respecto.
- Si es
is-sticky, debe poder descartarse — un banner fijo que no se va estorba.
Cómo no usarlo
- No se usa de cartel publicitario permanente: se vuelve ciego y tapa contenido.
- El color no debe cargar solo con el significado: el texto tiene que decirlo.
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
El banner se puede descartar, y eso lo hace el Core.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-dismissdata-ts-dismissible
Qué hace: El botón de cerrar saca el banner del DOM (o lo oculta) y, si corresponde, recuerda que se descartó.
Sin build, desde el CDN: taisho.banner.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
- Se escribe como
<div role="region" aria-label="…">, con un nombre propio por aviso (norole="banner": ése es el encabezado de la página y un sitio con su propio<header>tendría dos). Dos avisos con el mismo nombre no se distinguen en la lista de regiones. - El color no es el único portador de significado: el mensaje de texto siempre comunica el estado.
- El botón de cierre tiene
aria-labelpropio.
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.