Basic dialog

How to test a basic dialog

Gherkin Condensed

Given that I am on a screen with a basic dialog

WHEN I use the tab key or arrow key to move focus to the launch button AND THEN use spacebar to activate the button I SEE the dialog opens
Then when I use the arrow keys I SEE content in the dialog is browsed in meaningful order and does not leave the dialog
Then when I use the tab key I SEE focus moves to interactive controls in the dialog

WHEN I use a screenreader AND I swipe to focus to the launch button
- I HEAR the dialog describes its purpose or title on launch
- I HEAR it identifies itself as a dialog
- I HEAR when closed, focus returns to launch button or meaningful next step
- I HEAR when open, content behind the dialog remains inert
Then when I doubletap with the button in focus I HEAR the dialog opens
Then when I swipe within the dialog I HEAR focus stays trapped in the dialog

When I use Text resize I SEE text content can resize up to 200% without losing information

When I use	I see/hear
Launch button	Focus visibly moves to the open dialog itself
Arrow keys	Content within the dialog is browsed in meaningful order
Tab	Focus visibly moves to interactive controls in the dialog
Space or enter	Any buttons are activated

When I use	I hear
Swipe	Focus moves within the dialog and doesn't enter the rest of the page
Doubletap	Activates controls

Reads	I hear
Name	The dialog describes its purpose or title on launch
Role	It identifies itself as a dialog
Group	When closed, focus returns to launch button or meaningful next step
State	When open, content behind the dialog remains inert

When I use	I see
Text resize	Text content can resize up to 200% without losing information

Usage

Basic dialogs provide important prompts in a user flow, making sure people act on information.

Commonly used to confirm high-risk actions like deleting progress
Should be dedicated to completing a single task (ex: Are you sure you want to unsubscribe? Yes/No)

Upon completing the single task (ex: Are you sure you want to unsubscribe? Yes/No) focus should be returned to the button that launched the dialog or a meaningful next step in the application.