Dialogue

Dialogue interrupt users with urgent information, details, or actions. Common usage includes confirming a destructive action, or informing the user of something instantly.

• A dialogue should not exceed 400 units in width and height.

• A dialogue is modal with the Window, and displays a scrim behind it.

• A dialogue fades in, and scales up from 80% to 100% (its final size.) A background scrim fades in, in front of app content.

• A dialogue stays in focus and does not scroll until the user has dismissed or gone through with its associated confirmation.

• A dialogue should not contain, or make happen, scrollable contents.

Remember these extra guidances as well for messaging in dialogues:

Say what happened — Make it clear what did/didn’t happen. Explain why the user got this error, even if the only explanation is technical.

Provide reassurance — Where possible, let them know what was not affected by the error.

Be empathetic — Still use “please” if the situation warrants it. Maybe it’s a really dire situation, so empathize.

Help them fix it — Tell them exactly what to do if there’s a way to possibly fix it.

Always give a way out — If they can’t fix the problem, provide them with a way to contact.