Dialogs

  • Dialogs are modal windows that require immediate user interaction and retain focus until dismissed or action is taken.

  • Unlike Toasts, which display transient informative messages, Dialogs demand user responses and have higher priority.

  • They consist of a background, header (optional), content area, and an action area with controls like buttons or list items.

  • OEMs can customize dialog appearance using runtime overlays, adjusting fonts, button styles, dimensions, and placement according to brand guidelines.

  • Dialogs should be used sparingly due to their interruptive nature, reserving them for crucial tasks and decisions.

A dialog is a modal window that appears in front of an app to display task information that requires an immediate user response.

A dialog can be an alert, which requires user interaction. It can also be a selection or confirmation dialog, which requires a user to make or confirm a choice. The dialog retains focus until it’s dismissed or the required action is taken. Because dialogs are interruptive, they should be used sparingly.

Dialogs are related to toasts (both are members of the Dialog family of components), but they differ in purpose and priority, as shown below.

Component Purpose Priority
Toasts Displays an informative message. Doesn’t require user interaction. Disappears after 8 seconds. Low
Dialog Displays information and task options that require user interaction. A dialog retains focus until a user responds. High

Anatomy

Dialogs contain informational text and UI controls that request a user response.

1. Dialog background
2. Card header
3. Content area
4. Card action area

Specs

Dialog without title

Dialog with title

Dialog with centered title

Scrollable dialog


Customization

OEMs can reflect their brand by customizing the following aspects of dialogs:

  • Fonts
  • Styling of active, inactive, and disabled buttons
  • Button dimensions and placements

Design system provides guidance for customizing components using layout, color, typography, and sizing.


Examples

Dialog with title - day
Dialog with title - night
Scrollable dialog - day
Scrollable dialog - night
Dialog in action