Saltar al contenido

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

Todavía no hay despliegues

Cuando se lance el primero, aparecerá en esta lista.

html

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 skeleton o spinner, no un vacío.
  • Es un error del sistema, no un estado sin datos → banner o note.

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”.

Relacionados

TableSkeletonNote

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.