This page describes the problems that WAI-ARIA addresses, and introduces the WAI-ARIA suite of technical documents. Many of the terms used in this page—including Web content, user agents, and assistive technology—are described in Introduction to Web Accessibility and Essential Components of Web Accessibility.
WAI-ARIA provides a framework for adding attributes to identify features for user interaction, how they relate to each other, and their current state. WAI-ARIA describes navigation techniques to mark regions and common Web structures as menus, primary content, secondary content, banner information, and other types of Web structures. For example, with WAI-ARIA, developers can identify regions of pages and enable keyboard users to easily move among regions, rather than having to press Tab many times.
WAI-ARIA also includes technologies to map controls, live regions, and events to accessibility application programming interfaces (APIs), including custom controls used for rich Internet applications. WAI-ARIA techniques apply to widgets such as buttons, drop-down lists, calendar functions, tree controls (for example, expandable menus), and others.
WAI-ARIA provides Web authors with the following:
- Roles to describe the type of widget presented, such as “menu”, “treeitem”, “slider”, and “progressbar”
- Roles to describe the structure of the Web page, such as headings, and regions
- Properties to describe the state widgets are in, such as “checked” for a check box, or “readonly” for most form controls
- Properties to define live regions of a page that are likely to get updates (such as stock quotes)
- A way to provide keyboard navigation for the Web objects and events, such as those mentioned above
Authoring Practices Guide (APG)
ARIA Authoring Practices Guide (APG), recommends approaches to help web application developers make widgets, navigation, and behaviors accessible using WAI-ARIA roles, states, and properties.
It describes considerations that might not be evident to most authors from the WAI-ARIA specification, which is oriented primarily at user agent implementers.
WAI-ARIA 1.2 was published as a completed W3C Recommendation on 6 June 2023.
WAI-ARIA 1.3 Draft is under development. Proposed changes from ARIA 1.2 include:
- new roles: suggestion, comment, mark
- new attributes: aria-description, aria-braillelabel, aria-brailleroledescription
- updates to aria-details to allow multiple IDrefs
Additional changes are in the changelog.
The 1.2 version extends WAI-ARIA 1.1 to add a small number of features to the HTML + ARIA accessibility model. For 1.2, user agent implementation guidance is provided as a suite of accessibility API mapping specifications that describe how to expose semantics of WAI-ARIA and other web content languages to accessibility APIs.
Published WAI-ARIA Specifications are as follows:
- WAI-ARIA 1.2 technical specification, provides features to define accessible user interface elements and in order to improve the accessibility and interoperability of web content and applications. It is primarily for developers of Web browsers, assistive technologies, and other user agents; developers of Web technologies (technical specifications); and developers of accessibility evaluation tools.
- Core Accessibility API Mappings 1.2, describes how user agents should expose semantics of web content languages to accessibility APIs. The core module defines support that applies across multiple content technologies, including general keyboard navigation support and mapping of general-purpose WAI-ARIA features; other specifications will extend this for specific technologies.
- Accessible Name and Description Computation 1.2, describes how user agents determine names and descriptions of accessible objects from web content languages and expose them in accessibility APIs. This allows assistive technologies to associate and relay the name or description of objects to users.
- HTML Accessibility API Mappings 1.0, defines how user agents map HTML elements and attributes to platform accessibility application programming interfaces (APIs). It leverages and extends the Core Accessibility API Mappings 1.2 and the Accessible Name and Description Computation 1.2 for use with the HTML host language. Documenting these mappings promotes interoperable exposure of roles, states, properties, and events implemented by accessibility APIs and helps to ensure that this information appears in a manner consistent with author intent.
- SVG Accessibility API Mappings 1.0, extends Core Accessibility API Mappings 1.2 to define how user agents map SVG markup to platform accessibility application programming interfaces (APIs). When supported by user agents, its features allow SVG authors to create accessible rich internet applications, including charts, graphs, and other drawings. Provides SVG-specific guidance for how the SVG user agent must respond to keyboard focus, native SVG features, and role, state and property attributes provided via WAI-ARIA.
Additional documents are expected in this suite, including other accessibility API mappings and updated authoring guidance. Editors’ drafts under development can be accessed in the WAI-ARIA GitHub Repositories.
W3C Recommendations and Working Group Notes are briefly explained in How WAI Develops Accessibility Guidelines through the W3C Process, which also describes milestones in the W3C Process.
Technical document format
The WAI-ARIA documents follow the W3C format for technical specifications which includes several sections at the beginning: links to different versions, editors, copyright, abstract, and status with the link to errata and the email address for comments.
Who develops WAI-ARIA
The WAI-ARIA technical documents are developed by the Accessible Rich Internet Applications Working Group (ARIA WG), which is part of the World Wide Web Consortium (W3C) Web Accessibility Initiative (WAI). For more information about the working group, see the ARIA WG public page.
How WAI Develops Accessibility Guidelines through the W3C Process: Milestones and Opportunities to Contribute describes formal periods for public review. Opportunities for review and comment of WAI documents are announced on the WAI home page and WAI Interest Group mailing list. An email address for sending comments is included in the “Status of this Document” section.
Opportunities for contributing to WAI-ARIA and other WAI work are introduced in Participating in WAI.Back to Top