Feedback
Toast, Banner, Callout, errores de campo, Alert Dialog y Empty, ordenados por urgencia, por cuánto duran y por cuánto de la app representan.
El feedback responde una de tres preguntas: ¿funcionó?, ¿algo anda mal?, ¿y ahora qué? El componente que elegís decide qué tan fuerte respondés, cuánto dura la respuesta y cuánto de la pantalla ocupa. Si acertás en esas tres cosas, escribir el mensaje se vuelve mucho más fácil.
Tabla de decisión
| Componente | Urgencia | Cuánto dura | Alcance | Interrumpe |
|---|---|---|---|---|
| Toast | Baja. El resultado de una acción | 5 segundos, 10 si tiene acción | Lo que la persona acaba de hacer | Solo errores y advertencias, se leen enseguida |
| Error de campo | Media. Impide enviar | Hasta que se corrige el valor | Un campo | No |
| Resumen de errores | Media. Varios problemas | Hasta que se corrigen los campos | Un formulario | Mueve el foco una vez |
| Callout | Baja. Contexto que vale la pena leer | Siempre, es parte del contenido | Una sección | No |
| Banner | Media a alta | Hasta que termina el estado o se descarta | Toda la app o la página | No, salvo con role="alert" |
| Alert Dialog | Alta. Necesita una decisión | Hasta que se responde | La tarea en curso | Sí, es modal |
| Empty | Ninguna. No hay nada mal | Mientras no haya nada para mostrar | Una lista, una tabla, un panel | No |
Dos pruebas rápidas resuelven la mayoría de los casos. Si el mensaje es sobre algo que la persona escribió, va al lado de lo que escribió. Si sigue siendo cierto después de que se va de la página, no va en un toast.
Toast
Un Toast confirma algo que la persona acaba de hacer y se corre del medio. "Invitación enviada", "Cambios guardados", "3 conversaciones archivadas". Se lee en una región en vivo, el temporizador se pausa con hover y foco, y con una acción queda 10 segundos en vez de 5.
Igual desaparece. Todo lo que la persona tenga que resolver, o quiera leer dos veces, necesita un lugar que se quede.
3 conversaciones archivadas
Las encontrás en Archivo cuando las necesites.
DeshacerProyecto eliminado
acme-web y sus 14 deploys ya no existen.
Deshacer- Un toast por acción. Tres toasts por un clic es ruido, y
maxToastsva a empezar a descartarlos igual. - No avises con un toast lo que la pantalla ya muestra. Si la fila nueva aparece en la tabla, "Fila agregada" no suma nada.
- Los errores en toasts son para fallas que la persona no puede corregir ahí mismo, como un error de red al guardar. Decí qué falló y qué probar.
Errores de un formulario
Los errores de validación van al lado del campo que los causó, con
Field.Error. Ahí es donde la persona está mirando, se quedan hasta que lo corrige, y el aria-describedby del campo apunta al mensaje para que los lectores de pantalla lo lean junto con el label.Te mandamos la factura acá.
Escribí un email como ana@northwind.dev.
Email inválido
En formularios largos, agregá
Form.ErrorSummary arriba. Después de un envío fallido lista cada problema como un link a su campo, y el foco salta al primero inválido. Los detalles están en Formularios.Banner y Callout
Un Banner habla por toda la app o por toda la página: una prueba que termina en tres días, un espacio de trabajo en solo lectura, una caída del servicio, un problema de facturación. Se queda hasta que cambia el estado o la persona lo descarta. Ponelo arriba, por encima del layout, y de a uno por vez.
Un Callout habla por una sección. Vive dentro del contenido, al lado de lo que explica, y no se puede descartar porque es parte de la página.
Tu espacio de trabajo es de solo lectura hasta las 14:00 UTC
Lo estamos moviendo a otra región. No se pierde nada y la edición vuelve sola.
Tip
Arrastrá los encabezados de esta tabla para reordenarlos.
La versión local de ese mensaje es un Callout, justo arriba de la tabla:
Rotar la clave cierra todas las sesiones
Las sesiones activas terminan en menos de un minuto. Hacelo fuera del horario laboral.
Los banners usan
role="region" por defecto, que los lectores de pantalla listan pero no anuncian. Usá role="alert" solo cuando inyectás un banner porque acaba de pasar algo urgente, porque interrumpe lo que la persona esté haciendo.Alert Dialog
La opción más fuerte. Bloquea la página y espera una respuesta. Usalo cuando la persona está por perder algo que no puede recuperar, y para nada más. El razonamiento completo está en Overlays.
Empty
Un estado Empty también es feedback: le dice a la persona que esa zona funciona y simplemente está vacía, y le dice qué hacer al respecto. Todo estado vacío necesita un próximo paso. En la primera visita es la acción que lo llena. Después de una búsqueda sin resultados, es una forma de limpiar o cambiar la búsqueda.
Todavía no hay facturas
Las facturas aparecen acá después del primer pago. Agregá una tarjeta para activar el plan.
Sin datos
Cargando no es vacío. Mostrá un skeleton o un spinner mientras llegan los datos, y mostrá el estado vacío solo cuando sabés que no hay nada.
¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.