Saltar al contenido

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

html

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.

html

Estados

is-sticky fija el banner arriba mientras se scrollea.

html

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 error del field.

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.

Relacionados

NoteToast

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-dismiss
  • data-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.css
  • taisho.icon.css
  • taisho.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 (no role="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-label propio.

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.