Dialog

Keyboard

Enter or Space

Activates the trigger or a focused close action.

Escape

Dismisses the open dialog and returns focus to its trigger.

Tab and Shift+Tab

Keeps focus within a modal dialog while it is open.

Focus

• Modal Dialog moves focus into its content after it opens.
• Modal Dialog restores focus to the trigger after dismissal.
• Background controls are isolated while a modal Dialog is open.

Semantics

• Content has role dialog and aria-modal=true for modal dialogs.
• Title and Description are connected to Content with aria-labelledby and aria-describedby.

ARIA

• Trigger exposes aria-haspopup=dialog.
• Trigger exposes aria-expanded and aria-controls while the dialog is open.
• Backdrop is hidden from assistive technology.

Consumer responsibilities

• Provide a concise Title and Description for every modal Dialog.
• Keep a visible, keyboard-operable dismissal action unless the workflow has a documented exception.
• Use an alert dialog for confirmations that require an explicit destructive-action decision.

Not applicable

portalling

Native portalling is deferred while Solid 2 Portal APIs are unstable; the API contract does not depend on DOM relocation.