From 40b6c227dd27fc3f5f496a792a39d04d8361b91e Mon Sep 17 00:00:00 2001 From: Matt King Date: Thu, 16 Nov 2017 14:36:28 -0800 Subject: [PATCH] Grid and Table Properties Section: Make Corrections for Issue 505 Per feedback in issue #505, modify the grid and table properties section of aria-practices.html to: 1. Correct spelling and spacing errors. 2. Clarify wording. Also, removed the link to feedback issue 505. --- aria-practices.html | 26 +++++++++++--------------- 1 file changed, 11 insertions(+), 15 deletions(-) diff --git a/aria-practices.html b/aria-practices.html index 27eda2b117..960bbbff4b 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -3876,14 +3876,10 @@

Exposing and Documenting Keyboard Shortcuts

Grid and Table Properties

-

- NOTE: The content in this section is new. Please provide feedback in - issue 505. -

To fully present and describe a grid or table, in addition to parsing the headers, rows, and cells using the roles described in the grid pattern or table pattern, - assistive technologies need to be able to determine : + assistive technologies need to be able to determine:

- Browsers can automatically calculate the number of rows and columns and put it into their accessibility tree based on what is in the DOM. - However, there are many situations where the DOM does not contain the whole table, such as when the data set is too large to fully render. + Browsers automatically populate their accessibility tree with the number of rows and columns in a grid or table based on the rendered DOM. + However, there are many situations where the DOM does not contain the whole grid or table, such as when the data set is too large to fully render. Additionally, some of this information, like skipped columns or rows and how data is sorted, cannot be derived from the DOM structure.

The below sections explain how to use the following properties that ARIA provides for grid and table accessibility.

@@ -3951,7 +3947,7 @@

Using aria-rowcount and aria-rowindex

When the number of rows represented by the DOM structure is not the total number of rows available for a table, grid, or treegrid, the aria-rowcount property is used to communicate the total number of rows available, - and it is accompanied by the aria-rowindex property to identify the row indicies of the rows that are present in the DOM. + and it is accompanied by the aria-rowindex property to identify the row indices of the rows that are present in the DOM.

The aria-rowcount is specified on the element with the table, grid, or treegrid role. @@ -3967,11 +3963,11 @@

Using aria-rowcount and aria-rowindex

  1. Greater than or equal to 1.
  2. Greater than the value of aria-rowindex on any previous rows.
    3. -
  3. If cells span multiple rows, set to the index of the first row in the span.
    4. +
  4. Set to the index of the first row in the span if cells span multiple rows.
  5. Less than or equal to the total number of rows.

- WARNING! Missing or inconsistent values of aria-rowindex could have devistating effects on assistive technology behavior. + WARNING! Missing or inconsistent values of aria-rowindex could have devastating effects on assistive technology behavior. For example, specifying an invalid value for aria-rowindex or setting it on some but not all rows in a table, could cause screen reader table reading functions to skip rows or simply stop functioning.

@@ -4041,8 +4037,8 @@

Using aria-rowcount and aria-rowindex

Using aria-colcount and aria-colindex

When the number of columns represented by the DOM structure is not the total number of columns available for a table, grid, or treegrid, - the aria-colcount property is used to commyunicate the total number of columns available, - and it is accompanied by the aria-colindex property to identify the column indicies of the columns that are present in the DOM. + the aria-colcount property is used to communicate the total number of columns available, + and it is accompanied by the aria-colindex property to identify the column indices of the columns that are present in the DOM.

The aria-colcount is specified on the element with the table, grid, or treegrid role. @@ -4058,11 +4054,11 @@

Using aria-colcount and aria-colindex

  1. Greater than or equal to 1.
  2. When set on a cell, greater than the value set on any previous cell within the same row.
    3. -
  3. If a cell spans multiple columns, set to the index of the first column in the span.
    4. +
  4. Set to the index of the first column in the span if a cell spans multiple columns.
  5. Less than or equal to the total number of columns.

- WARNING! Missing or inconsistent values of aria-colindex could have devistating effects on assistive technology behavior. + WARNING! Missing or inconsistent values of aria-colindex could have devastating effects on assistive technology behavior. For example, specifying an invalid value for aria-colindex or setting it on some but not all cells in a row, could cause screen reader table reading functions to skip cells or simply stop functioning.

@@ -4111,7 +4107,7 @@

Using aria-colindex When Column Indicies Are Not Contiguous

When the cells in a row have column index numbers that are not consecutive integers, aria-colindex needs to be set on each cell in the row. The following example shows a grid for an online grade book where the first two columns contain a student name and subsequent columns contain scores. - In this example, the first two columns with the student name are shown, but the score columns have been scrolled to sshow columns 10 through 13. + In this example, the first two columns with the student name are shown, but the score columns have been scrolled to show columns 10 through 13. Columns 3 through 9 are not visible so are not in the DOM.