Toast
A toast is a temporary notification that informs users on the outcome of an action.
Anatomy
The toast component is made up of two elements.
- Notification
- Default slot
Variants
Appearance
Neutral
Neutral toasts are used in contexts that are largely informative and have no positive or negative connotation.
Positive
Positive toasts are used in contexts that convey a positive connotation such as approved, complete, and deposited.
Negative
Negative toasts are used in contexts that convey a negative connotation such as error, alert, or rejected.
Icon
A user-customizable icon can be paired with the text for increased visual emphasis.
Dismiss button
An icon-only dismiss button can be included to clear the toast. The icon is user-customizable.
Action buttons
Buttons can be used to provide the user a contextual action.
Stacked
By default, action buttons are in line with the text. However, they can be stacked below the text in situations where either the text or the button label are relatively long.
Behavior
Dismiss
Toasts are set to auto-dismiss after five seconds by default, but they may be manually dismissed if needed. The user can adjust the timeout that denotes when the toast will dismiss as well as set it to a value that will functionally disable auto-dismiss.
Text overflow
Notifications resize to fill the width of the toast container. Text within each notification wraps according to the default notification text overflow behaviors.
Component tokens
The following component tokens are available for customizing the toast component.
Sample references including the swatch and computed values currently represent the applied light theme.
The token lists can be copied into tabular format for pasting into spreadsheets or other applications. Use these to help you document product-specific customizations or perform fine-grained filters.
Shadow
Other
Dependencies
The toast component uses the following components:
