Saltar al contenido

Note

Bloque de mensaje contextual dentro del contenido, no de ancho completo. Es el lugar de las aclaraciones, advertencias y tips que van pegados a lo que están explicando. Admite título, acciones y cierre.

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.

Dato informativo

Dato

TaishoDS Core funciona en cualquier stack, sin build.
html

Advertencia

Ojo

Las fuentes las aporta cada proyecto.
html

Peligro descartable

html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Variante

El color según el tono de la nota: default, success, warning, info o danger.

Dato

TaishoDS Core funciona en cualquier stack, sin build.

Listo

Despliegue completado.

Ojo

Tu plan está por vencer.

Novedad

Nueva versión disponible.
html

Cuándo usarlo

  • La aclaración sólo tiene sentido al lado de lo que acompaña (un paso, un campo, un párrafo).
  • Se busca destacar algo del contenido sin sacar al usuario de donde está.
  • Hace falta jerarquía por variante (info, éxito, advertencia, peligro) dentro de la página.

Cuándo no

  • El estado es de toda la página o la app → banner.
  • Es efímero y no hace falta que quede escrito → toast.
  • Es sólo una etiqueta corta de estado, sin prosa → badge.

Cómo usarlo

  • La nota va junto a lo que explica, no al final de la página.
  • ts note-title se usa cuando el cuerpo pasa de una línea: da el resumen de un vistazo.

Cómo no usarlo

  • No se salpican notas cada dos párrafos: si todo está destacado, nada lo está.
  • La información esencial no va en una nota descartable.

Relacionados

BannerToastBadge

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

La nota descartable se oculta con su botón de cerrar, 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 con data-ts-dismiss oculta la nota (data-ts-dismissible) y avisa con ts:change. Sin botón de cerrar es marcado estático.

Sin build, desde el CDN: taisho.note.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

  • El color nunca es el único indicador: el auto-ícono y el texto comunican la variante.
  • El botón de cierre expone 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.