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
Advertencia
Ojo
Peligro descartable
Cuidado
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
Listo
Ojo
Novedad
Cuidado
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-titlese 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.
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-dismissdata-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.csstaisho.icon.csstaisho.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-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.