Skip to content

Commit

Permalink
Grid and Table Properties Section: Make Corrections for Issue 505
Browse files Browse the repository at this point in the history
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.
  • Loading branch information
mcking65 committed Nov 16, 2017
1 parent c0a55ba commit 40b6c22
Showing 1 changed file with 11 additions and 15 deletions.
26 changes: 11 additions & 15 deletions aria-practices.html
Original file line number Diff line number Diff line change
Expand Up @@ -3876,14 +3876,10 @@ <h4>Exposing and Documenting Keyboard Shortcuts</h4>

<section id="gridAndTableProperties">
<h2>Grid and Table Properties</h2>
<p>
<strong>NOTE:</strong> The content in this section is new. Please provide feedback in
<a href="https://github.com/w3c/aria-practices/issues/505">issue 505.</a>
</p>
<p>
To fully present and describe a grid or table, in addition to parsing the headers, rows, and cells using the roles described in the
<a href="#grid">grid pattern</a> or <a href="#table">table pattern</a>,
assistive technologies need to be able to determine :
assistive technologies need to be able to determine:
</p>
<ul>
<li>The number of rows and columns.</li>
Expand All @@ -3892,8 +3888,8 @@ <h2>Grid and Table Properties</h2>
<li>Whether and how data is sorted.</li>
</ul>
<p>
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.
</p>
<p>The below sections explain how to use the following properties that ARIA provides for grid and table accessibility.</p>
Expand Down Expand Up @@ -3951,7 +3947,7 @@ <h3>Using <code>aria-rowcount</code> and <code>aria-rowindex</code></h3>
<p>
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 <code>aria-rowcount</code> property is used to communicate the total number of rows available,
and it is accompanied by the <code>aria-rowindex</code> property to identify the row indicies of the rows that are present in the DOM.
and it is accompanied by the <code>aria-rowindex</code> property to identify the row indices of the rows that are present in the DOM.
</p>
<p>
The <code>aria-rowcount</code> is specified on the element with the <code>table</code>, <code>grid</code>, or <code>treegrid</code> role.
Expand All @@ -3967,11 +3963,11 @@ <h3>Using <code>aria-rowcount</code> and <code>aria-rowindex</code></h3>
<ol>
<li>Greater than or equal to 1.</li>
<li>Greater than the value of <code>aria-rowindex</code> on any previous rows.</li>
<li>If cells span multiple rows, set to the index of the first row in the span.</li>
<li>Set to the index of the first row in the span if cells span multiple rows.</li>
<li>Less than or equal to the total number of rows.</li>
</ol>
<p>
<strong>WARNING!</strong> Missing or inconsistent values of <code>aria-rowindex</code> could have devistating effects on assistive technology behavior.
<strong>WARNING!</strong> Missing or inconsistent values of <code>aria-rowindex</code> could have devastating effects on assistive technology behavior.
For example, specifying an invalid value for <code>aria-rowindex</code> 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.
</p>
<p>
Expand Down Expand Up @@ -4041,8 +4037,8 @@ <h3>Using <code>aria-rowcount</code> and <code>aria-rowindex</code></h3>
<h3>Using <code>aria-colcount</code> and <code>aria-colindex</code></h3>
<p>
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 <code>aria-colcount</code> property is used to commyunicate the total number of columns available,
and it is accompanied by the <code>aria-colindex</code> property to identify the column indicies of the columns that are present in the DOM.
the <code>aria-colcount</code> property is used to communicate the total number of columns available,
and it is accompanied by the <code>aria-colindex</code> property to identify the column indices of the columns that are present in the DOM.
</p>
<p>
The <code>aria-colcount</code> is specified on the element with the <code>table</code>, <code>grid</code>, or <code>treegrid</code> role.
Expand All @@ -4058,11 +4054,11 @@ <h3>Using <code>aria-colcount</code> and <code>aria-colindex</code></h3>
<ol>
<li>Greater than or equal to 1.</li>
<li>When set on a cell, greater than the value set on any previous cell within the same row.</li>
<li>If a cell spans multiple columns, set to the index of the first column in the span.</li>
<li>Set to the index of the first column in the span if a cell spans multiple columns.</li>
<li>Less than or equal to the total number of columns.</li>
</ol>
<p>
<strong>WARNING!</strong> Missing or inconsistent values of <code>aria-colindex</code> could have devistating effects on assistive technology behavior.
<strong>WARNING!</strong> Missing or inconsistent values of <code>aria-colindex</code> could have devastating effects on assistive technology behavior.
For example, specifying an invalid value for <code>aria-colindex</code> 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.
</p>
<section id="gridAndTableProperties_cols_contiguous">
Expand Down Expand Up @@ -4111,7 +4107,7 @@ <h4>Using <code>aria-colindex</code> When Column Indicies Are Not Contiguous</h4
<p>
When the cells in a row have column index numbers that are not consecutive integers, <code>aria-colindex</code> 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.
</p>
<pre>
Expand Down

0 comments on commit 40b6c22

Please sign in to comment.