Skip to content

Dialogs ​

They inform users about a task and can contain critical information, require decisions, or involve multiple tasks.

Dialogs

Principles ​

Focused: They focus user attention to ensure their content is addressed.

Direct: Dialogs should be direct in communicating information and dedicated to completing a task.

Helpful: They should appear in response to a user task or an action, with relevant or contextual information.

When to use ​

They have the highest priority in contrast to banners and snackbars.

Dialogs should be used when you need to block the user's app usage until they take a dialog action or exit the dialog.

Types ​

Alert ​

These types of dialogs interrupt users with urgent information, details or actions.

Dialogs alert

Simple ​

Simple dialogs display elements that take immediate effect when selected.

Dialogs simple

Confirmation ​

These dialogs require users to confirm a choice before the dialog is dismissed.

Dialogs confirmation

Full-screen ​

Full-screen dialogs are only for mobile devices. Modal dialogs MUST be used for desktop and tablets.

These dialogs include components which require keyboard input, such as form fields.

Dialogs full-screen

Design guidelines ​

Anatomy ​

Dialogs anatomy

  1. Container
  2. Title (optional)
  3. Supporting text
  4. Action buttons
  5. Scrim (only for modal dialogs)

Title ​

The dialog's purpose should be communicated by its title and button text.

Titles should contain a clear statement or a question.

Dialogs title do

Avoid apologies, alarm or ambiguity.

Dialogs title dont

Action buttons ​

Side-by-side buttons.

Dialogs actions

Dismissive actions are placed to the left of confirming options.

Stacked full-width buttons accommodate longer text.

Dialogs actions

Confirming actions appear above dismissive actions.

Specs ​

Dialogs specsDialogs specsDialogs specsDialogs specsDialogs specs