FPWD: WAI-ARIA Authoring Practices 1.2

WAI-ARIA Authoring Practices 1.2

https://www.w3.org/TR/2018/WD-wai-aria-practices-1.2-20180719/

Abstract


This document provides readers with an understanding of how to use WAI-ARIA 1.2 [WAI-ARIA-1.2] to create accessible rich internet applications. It describes considerations that might not be evident to most authors from the WAI-ARIA specification alone and recommends approaches to make widgets, navigation, and behaviors accessible using WAI-ARIA roles, states, and properties. This document is directed primarily to Web application developers, but the guidance is also useful for user agent and assistive technology developers.

This document is part of the WAI-ARIA suite described in the WAI-ARIA Overview.

Status of the Document


This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.

This is a First Public Working Draft of WAI-ARIA Authoring Practices 1.2 by the Accessible Rich Internet Applications (ARIA) Working Group. It supports the WAI-ARIA 1.2 [WAI-ARIA-1.2] specification, providing detailed advice and examples beyond what would be appropriate to a technical specification but which are important to understand the specification.

This draft includes only a portion of content planned for WAI-ARIA Authoring Practices 1.2. To see plans for the complete guide, review the Authoring Practices Milestone Plan.

Feedback on the information provided here is essential to the ultimate success of Rich Internet Applications that afford full access to their information and operations. The Accessible Rich Internet Applications Working Group asks in particular: Is it clear how to create accessible Rich Internet Applications? Is the usage of roles, states, and properties clear? Are the various types of rich Web content covered? Are considerations beyond the use of WAI-ARIA sufficiently explained? Is the relationship of this document to the WAI-ARIA specification clear? Are the design patterns clear?

To comment, file an issue in the W3C aria-practices GitHub repository, or if that is not feasible, send email to public-aria@w3.org (comment archive). In-progress updates to the document may be viewed in the publicly visible editors' draft.

This document was published by the Accessible Rich Internet Applications Working Group as a First Public Working Draft.

Publication as a First Public Working Draft does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.

This document was produced by a group operating under the W3C Patent Policy. The group does not expect this document to become a W3C Recommendation. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.

This document is governed by the 1 February 2018 W3C Process Document.