patterns / null

Notification

Quick Use Cases

| Use Case | Option(s) | | :-------------------------------------------------------- | :---------------------------- | | New feature announcement | Announcement | | System wide error message | Announcement | | Confirmation of Deletion on critical action | Dialog | | Upload in progress | Toast | | Message to user that comes from different part of the app | Toast | | Success message for data update on a table cell | Toast | | Error message for a form group | Banner |


Message Priority

When deciding what to use for a notification, you have to understand how important the message is to the user and/or the system.

High

  • Messages that persist across the entire app (system or account level)
  • Messages that require an interruption and user action to proceed
  • Messages that are important for users to see from ST’s perspective - new feature announcement etc.

Medium

  • Messages to indicate status of information on a page
  • Messages to indicate status of actions taken, including additional information on how to proceed

Low

  • Messages to indicate status of actions taken, without needing additional information or actions

| Name | High | Medium | Low | | :---------------------------- | :--: | :----: | :-: | | Announcement | ✓ | | | | Dialog | ✓ | | | | Toast | ✓ | ✓ | ✓ | | Banner | | ✓ | ✓ |


Announcement

Announcement component can be used for high priority notification that is persistent across the entire application. Primary use cases are to notify things such as *New Feature *or System-Wide status such as "Server is down" or "Unable to connect to the Internet." Announcements should not stack and only appear one at a time.


Dialog

Dialog is a component that can be used for notification. It can be used for high priority notification that interrupts user until an action is taken. A primary use case is Confirmation of Deletion on critical information.


Toast

Toast component can be used as any priority notifications. The notification is not bound to the current page content, and it can notify users about another part of the app. By default, it can stack up to 5 and also queues after 5 showing visually. A primary use case is a notification to show the progress bar.


Banner component is used for contextual(inline) notification for items such as a page or a section on a page. It can be used for medium to low priority notification and ideally placed above the related content. A primary use case is to show error messages for a form group.

Multiple Banners

For the same section with the same statuses, combine them into one Banner.

For the same section with different statuses, create a Banner for each with higher priority on top (max 2).