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