Light themes
Dark themes

Make your own

Toast

A toast confirms that something just happened, in a small panel at the corner of the screen that leaves by itself.

Order archived

Receipt sent

To dana@example.com

Playground

One toast drawn in place: TrayUI.toast() builds this markup in the corner of the screen. Pick its tone, its words and whether it offers one action.

HTML

Use

JavaScript
TrayUI.toast({ title: 'Order archived', action: { label: 'Undo', onClick: restore } });
TrayUI.toast({ tone: 'success', title: 'Receipt sent', text: 'To dana@example.com' });
TrayUI.toast({ tone: 'danger', title: 'The export failed', text: 'Check the connection and try again.' });
OptionMeaning
titleWhat happened, in three or four words.
textOne more line, when needed.
tone'success' or 'danger' add an icon in that colour. Leave it out for a neutral toast.
actionOne button: { label, onClick }. "Undo" is the best action a toast can have.
durationMilliseconds on screen; default 5000. A danger toast, and a toast with an action, stay until dismissed.

Toasts stack at the bottom end corner in a tray-toasts region; the timer pauses while the pointer or focus is on one. Each is a raised row with 16px corners and the float shadow, read out politely (errors at once).

The markup of one toast is a tray-toast with an optional icon, a tray-toast__body holding tray-toast__title and tray-toast__text, and tray-toast__actions.

A toast rises in and, when it is dismissed or its time is up, sinks out quicker than it came; then it is taken away.

Toast or Alert

A toast is for what already happened and needs no decision. Something the person must read or act on goes in an Alert in the page, or in a Dialog.

Accessibility

  • The region the script makes for the toasts is the live one: a role="region" named "Notifications", with aria-live="polite", at the end of the page. A toast added to it is read out once, politely; a danger toast is a role="alert" and is read at once. The first toast in a region that has only just been made has its words put in again a moment later, so it is read too.
  • Focus stays where it was, so Tab reaches a toast after everything else on the page.
  • A toast with an action stays until it is dismissed, so there is time to reach its button (WCAG 2.2.1). Any other toast leaves after duration, and waits while the pointer or focus is on it.
  • Dismissing a toast, or running its action, moves focus that was in it to the next toast, or back to where it came from, never to the top of the page.
  • The close button is named "Dismiss". A tone always comes with its icon and the words of the title, so colour is never the only sign.
  • Under prefers-reduced-motion: reduce a toast appears and goes at once.

Do and don't

  • Do offer Undo instead of asking "Are you sure?" beforehand.
  • Do keep one toast per event, and no more than three on screen.
  • Don't put an error about a form field in a toast; put it under the field.
  • Don't use a toast for something that takes longer than a glance to read.
↑↓ to moveEnter to openEsc to close