Prepared Docs

Prepared Docs

⌘K

    Loading navigation…

User

  1. Blocks
  2. Takeover Dialog
  3. Accessibility

Takeover dialog

Accessibility

TakeoverDialog is a modal dialog. The accessible name is title. The heading is an h2 with that same text. description, when set, is the accessible description. The close control's name is closeLabel.

Keyboard

  • Escape closes the dialog and moves focus to the trigger that opened it.
  • No trigger. Focus returns to the element that was focused before the dialog opened.
  • Body. The body scrolls inside the dialog. Pass scrollRegionLabel when it overflows and holds no focusable control, so a keyboard user can reach it.
  • Backdrop. A press on the backdrop does not close the dialog. The page behind it is inert.

Cancel a cancelable close with details.cancel() when a parent owns the close, such as a confirm dialog inside the body.

Scroll

The page does not scroll while the dialog is open. The body is the scroll region. The title, the description, and the footer stay in view.

Window

The dialog is in the trigger's owner document, including a pop-out opened with window.open. A theme region on a parent subtree does not restyle the surface.

Previous

Takeover dialog / API and Development

Next

Waveform Player / Usage

On this page

Keyboard
Scroll
Window