Saltar al contenido

Toast

Beta

Confirmación breve y transitoria de algo que la persona acaba de hacer.

Abrir en Figmaregistry/ds/toast.tsx

Cuándo usarlo

Un toast confirma: "guardado", "copiado", "enviado". Desaparece solo, así que nunca puede llevar información que la persona necesite después.

Usá Toast para…Usá otra cosa para…
Confirmar una acción que ya terminó.Errores que hay que leer y resolver → Alert.
Ofrecer deshacer ("Mensaje archivado · Deshacer").Errores de un campo → error del Input.
Avisos de fondo que no bloquean.Decisiones ("¿Seguro?") → Modal.

Siguiendo una promesa

toast.promise() muestra "cargando" (con spinner, sin cierre automático) y se convierte en éxito o error con lo que devuelva la promesa. Un solo toast, no tres.

Apilado, persistente y prioridad

Se apilan de a tres y los demás esperan su turno. timeout: 0 deja el toast hasta que lo cierren: para acciones con Deshacer. Los danger interrumpen al lector de pantalla; el resto, no.

Reglas

  • Una línea de título; descripción solo si suma.
  • Máximo una acción, y que no sea la única forma de hacerla.
  • 5 segundos por defecto. Con acción o texto largo, dale más (timeout).
  • Se apilan hasta 3; los más viejos se ocultan. Si estás disparando muchos, agrupá ("3 archivos subidos").
  • Un error puede ir en toast solo si es recuperable y no pierde datos. Si no, Alert.