EmptyState
El bloque que va cuando una lista, tabla o vista no tiene contenido: ícono, título, descripción y acción, centrados y unificados, en vez de repetir el HTML en cada pantalla.
Contenido · 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.
Lista vacía con acción
Cuándo usarlo
- Una lista o tabla puede quedar vacía, sea por primera vez o por un filtro.
- Se busca convertir el vacío en el primer paso: crear, importar, invitar.
- Hace falta distinguir “todavía no hay nada” de “tu búsqueda no encontró nada”.
Cuándo no
- Todavía está cargando: eso es
skeletonospinner, no un vacío. - Es un error del sistema, no un estado sin datos →
banneronote.
Cómo usarlo
- Se explica por qué está vacío y qué hacer: la acción va en el propio bloque.
- El vacío inicial se diferencia del vacío por filtro; el segundo ofrece limpiar el filtro.
Cómo no usarlo
- No se deja una tabla en blanco sin explicación: parece que se rompió.
- No se usa el mismo texto para “sin datos” y para “sin resultados”.
TaishoDS Core
No necesita JavaScript: es marcado y CSS.
Composición de texto e ícono.
Sin build, desde el CDN: taisho.empty-state.css, además de taisho.base.css. También se carga:
taisho.icon.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- El ícono es decorativo (
aria-hidden): el mensaje lo comunica el texto. - El título y la descripción son texto real, legibles por lectores de pantalla.
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.