From fc5d1d58d5452b3168dc87994e2771581f78160c Mon Sep 17 00:00:00 2001 From: Evan Yamanishi Date: Wed, 15 Nov 2017 21:32:12 -0800 Subject: [PATCH] Intro Section: Minor editorial revisions (pull #522) Addresses comments from @sh0hji in issue #519. --- aria-practices.html | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/aria-practices.html b/aria-practices.html index 4609f502b5..96baa09e18 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -55,10 +55,9 @@

Introduction

This section is informative.

- WAI-ARIA Authoring Practices is a guide to understanding how to use - WAI-ARIA 1.1 - to create an accessible Rich Internet Application. - It provides guidance on appropriate application of WAI-ARIA, describes recommended WAI-ARIA usage patterns, and explains concepts behind them. + WAI-ARIA Authoring Practices is a guide for understanding how to use + WAI-ARIA 1.1 to create an accessible Rich Internet Application. + It provides guidance on the appropriate application of WAI-ARIA, describes recommended WAI-ARIA usage patterns, and explains concepts behind them.

Languages used to create rich and dynamic web sites, e.g., HTML, JavaScript, CSS, and SVG, do not natively include all the features required to make sites usable by people who use assistive technologies (AT) or who rely on keyboard navigation. @@ -67,10 +66,9 @@

Introduction

provides additional background on WAI-ARIA, summarizes those efforts, and lists the other documents included in the WAI-ARIA suite.

- With the understanding many prefer to learn from examples, after a brief Read Me First section, - the guide begins with ARIA implementation patterns for common widgets that both enumerate expected behaviors and demonstrate those behaviors with working code. + After a brief Read Me First section, the guide begins with ARIA implementation patterns for common widgets that both enumerate expected behaviors and demonstrate those behaviors with working code. The implementation patterns and examples refer to detailed explanations of supporting concepts in subsequent guidance sections. - The guidance sections cover topics, such as use of ARIA landmarks, making rich internet applications keyboard accessible, grid and table properties, and the effects of the presentation role. + The guidance sections cover more general topics such as use of ARIA landmarks, practices for keyboard interfaces, grid and table properties, and the effects of the presentation roles.

@@ -631,7 +629,7 @@

Combo Box

The options for a combobox to popup a grid, tree, or dialog were introduced in ARIA 1.1. Changes made in the ARIA 1.1 specification also add support for a code pattern that enables assistive technologies to present the textbox and popup as separately perceivable elements. both ARIA 1.0 and 1.1 patterns are described in the following sections. - While using the ARIA 1.1 pattern is recommended as soon as assistive technology support is sufficient, + While using the ARIA 1.1 pattern is recommended as soon as assistive technology support is sufficient, there are no plans to deprecate the ARIA 1.0 pattern.

@@ -1356,7 +1354,7 @@
Keyboard Interaction For Data Grids

See for cut, copy, and paste key assignments.

- +

Layout Grids for Grouping Widgets

@@ -4198,7 +4196,7 @@

Defining cell spans using aria-colspan and aria-rowspan The following example grid has a two row header. The first two columns have headers that span both rows of the header. - The subsequent 6 columns are grouped into 3 pairs with headers in the first row that each span two columns. + The subsequent 6 columns are grouped into 3 pairs with headers in the first row that each span two columns.

         
@@ -4207,7 +4205,7 @@ 

Defining cell spans using aria-colspan and aria-rowspanIndicating sort order with aria-sort

<th>Homework 4</th> <!-- aria-sort indicates the column with the heading - "Quiz 2" has been used to sort the rows of the grid. + "Quiz 2" has been used to sort the rows of the grid. --> <th aria-sort="descending">Quiz 2</th> <th>Homework 5</th>