Lead: Liav Nadler ONGOING
Related pages: Popups, Dialogs, Toast
| Table of Contents |
|---|
Description
A message popup is a small modal window containing Popup containing important information such as a warning, error message, or help text other important information
Usually it appears on user's action (e.g. clicking help icon) and it must be dismissed by the user before going back to the application
The popup contains of these elements:
...
.
Types
Type | Usage | Image |
|---|---|---|
Warning | A warning message informs the user about a potential problem, particularly one that could occur if the user continues with an action. |  |
Error | An error message informs the user about an error that has occurred. |  |
Information | An information message contains additional information relevant to the primary screen. |  |
Help | A help message contains an explanation of any element within the primary screen. |  |
Usage & Behavior
General guidelines
Structure
For basic popup structure → see Popups.
Message popups:
will have a type icon (e.g.
warning icon
- The message text
- Primary action button
- Cancel button (optional)
Types
...
...
...
...
...
...
Usage & Behaviour
General guidelines
Interaction
- The user can dismiss the popup by either clicking the X icon on the upper-right corner or by clicking the OK button
- When relevant, clicking the Cancel button closes the popup without performing any other action
Validations and errors
N/A
Best practices
<<e.g. Slider should display a .label its on>>
Accessibility compliance
<<In general each component should be A11y complied, please follow the 3 guidelines linked below. At the very least we should document that each component is in compliance with each of the 3>>
Focus management
<<How will the component work with keyboard only - without a mouse. Can be reference if written above
We already set a general guidelines described in Keyboard & Focus Management Guidelines >>
Screen reader support
<<Make sure the components support screen reader for content or behaviour where needed - see Screen Reader Guidelines >>
Contrast & size compliance
<<Visual designers must comply with the minimal of Contrast + Font Size Guidelines for each component>>
) to the left of the title.
may contain a Checkbox, allowing the user to declare a statement such as I understand or Don’t show this again.
 |  |
Dimensions
Message popup have three possible dimensions: small, medium and large, depending on the amount of content.
A small popup has a fixed width of 400px.
In this case, the height of the popup may vary from 260px to 460px.A medium popup has a fixed of 500 px.
In this case, the height of the popup may vary from 325px to 575px.A large popup has a fixed width of 600 px.
In this case, the height of the popup may vary from 390px to 690px.If the content does not fit within the largest popup size, a scrollbar will appear.
Small popup | Medium popup | Large popup |
|---|---|---|
 |  |  |
Content
Popup header will contain the name of the object that triggered it. See Popups for more information.
The title can wrap up to two lines. Beyond that it will be truncated, showing an ellipsis (…). In this case, hovering over the title will show a tooltip with the full title.
Best practices
General
Message popups are very intrusive. Only use them for important alerts or long help messages. For lower-priority messages → use a Toast.
Keep the title short and informative. The title should not include the name of the entity.
Keep the message text short and informative.
Use
A common example is when the user tries to leave a page without saving their work. In this case, a warning popup will appear:
...
Design
Zeplin link | Screen thumbnail |
|---|
Code
...
