Accessible dialog window

Overview

a11y-dialog is a lightweight and flexible script for building accessible dialog windows. The README states 1.7 Kb, says it follows the Dialog (Modal) pattern from the ARIA Authoring Practices Guide, and that it supports alert dialogs as per the WAI-ARIA specifications.

It exposes events to react to changes and provides both a DOM API and a JavaScript API. It also supports nested dialogs, which the README itself calls questionable, works with Shadow DOM and web components, and is unopinionated about styling. The README points to a documentation site and a CodeSandbox demo for usage.

Highlights

• Follows the Dialog (Modal) pattern from the ARIA Authoring Practices Guide (APG).
• Supports alert dialogs as per the WAI-ARIA specifications.
• Exposes events to react to changes, with both a DOM API and a JavaScript API.
• Plays nicely with Shadow DOM and web components; unopinionated about styling.
• Stated size of 1.7 Kb, with tests and documentation described as extensive.

Who it is for

For web developers who want modal dialogs or alert dialogs that follow the ARIA APG pattern, while keeping control over their appearance.

Installation

The README contains no installation step: it points to the documentation site and a CodeSandbox demo. The repository’s package.json declares a package named a11y-dialog, at version 8.1.5.

Read the README on GitHub

Points of attention

• The script is unopinionated about styling: the look of the dialog and its backdrop is yours to write.
• Nested dialogs are supported, but the README itself adds «however questionable».

Can an agent use it?

No SKILL.md, AGENTS.md, CLAUDE.md, Cursor rules or MCP server found at the root or in the README. This is a JavaScript library for web interfaces.