Dialog

Keyboard

Use Tab and Shift+Tab to move within Dialog and Escape to close it. AlertDialog does not close with Escape; use its confirm or cancel button.

Semantics

Include DialogTitle and DialogDescription. Check that focus returns to the Trigger when the dialog closes. Always provide a cancel action in AlertDialog.

Checklist

  • Use DialogTitle and DialogDescription, and check that the title and description are associated with the dialog.
  • Check the initial focus, keep Tab inside the modal and return focus to the Trigger when it closes.
  • AlertDialog focuses cancel first and does not close with Escape. Provide confirm and cancel buttons.
  • Check that both SplitDialog sections and their actions are reachable in reading order, including on narrow screens.

For contrast, zoom and screen reader checks, see the common accessibility checklist.