Skip to content
Matt King edited this page Sep 23, 2019 · 1 revision

Table of Contents

Deliverables

The primary deliverable of the ARIA Practices project is a W3C Note that serves as a guide for using ARIA to build accessible rich internet applications. The Note is also known as the "APG," which stands for either "ARIA Practices Guide" or "Authoring Practices Guide."

The planned scope of the APG includes:

  1. Examples: Cannonical reference implementations of common web GUI components that employ ARIA.
  2. Guidance: Explanations of the purposes and limitations of ARIA roles, states, and properties.
  3. How-to's: Approaches to specific aspects of designing and developing accessible rich internet applications, such as using ARIA landmarks and developing keyboard interfaces.
ARIA Practices project plans also include development of additional supporting deliverables:
  1. A regression testing framework for the reference examples included in the APG.
  2. A framework for assessing and web site for reporting on how well assistive technologies support APG reference implementations of web GUI components.
This page provides more detail about the overall scope of work planned for the APG and supporting deliverables. The timelines for completing this work are outlined in the Release Plans.

Role Coverage

Role Category Count Coverage
Widget 20 20: Explained in design patterns and demonstrated in examples. See Design Patterns Development Status
Document Structure 26 TBD
Landmark 8 8: Explained and demonstrated in Landmark Regions section.
Live Region 5 5: Explained in guidance section on live region attributes. See issue 78.
Window 2 2: Explained and demonstrated in design patterns. See Design Patterns Development Status
Total 69 35 + TBD in Structure

Note: The 12 ARIA 1.1 abstract roles are omitted because they MUST not be used by authors.

State and Property Coverage

ARIA 1.1 includes 48 states and properties, 46 of which are included in the initial release scope. See the development status of guidance sections.

Two excluded attributes:

  1. aria-dropeffect property (deprecated)
  2. aria-grabbed state (deprecated)

How-To's and Appendices

  1. ARIA basics: quick start section covering must-know basics.
  2. Accessible name calculation in the labeling and describing guidance section.
  3. How-to Section: Developing Keyboard Interfaces (Issue 220)
  4. How-to Section: Developing Custom Widgets (Issue 73)
  5. How-to section: Displaying Images and Symbols That Represent Widget States and Properties (Issue 274)
  6. Appendix explaining screen reader modes (Issue 193)
  7. Appendix describing ARIA background topics, e.g., why ARIA is necessary. (Issue 84)
Clone this wiki locally