diff --git a/aria-practices.html b/aria-practices.html index b8a6ce5297..d7c2745830 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -3865,27 +3865,76 @@
Accessibility APIs by default use the number of rows and columns to
- determine the dimensions of a table
or grid
.
- There are many situations where the number of rows and columns in the DOM
- does not represent the total number of rows and columns
- represented in the table
or grid
.
- Examples include very large data sets where rendering the entire data set
- in one table would be impractical, both from a screen realestate and
- performance standpoint (e.g. the time to download large sets of data).
- These conditions are especially apparent in mobile devices where screen size
- and bandwidth are serious limitations to how fast and how much data can be
- displayed at one time. ARIA provides support to describe the actual
- dimensions and the rendered portion of the table
or
- grid
using the colcount
, rowcount
,
- colindex
and rowindex
attributes within the
- context of a table
row.
+
+ NOTE: This is a draft section is not yet ready for review. + Work on this section is tracked by + issue 65.
- -ARIA defines other table
and grid
properties
- for identifying spanned rows and columns, and the sorting order of a column.
-
+
+ To 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 : +
++ Browsers can automatically calculate dimension information 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. + 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.
+Property | +Definition | +
---|---|
aria-colcount |
+ Defines the total number of columns in a table , grid , or treegrid . |
+
aria-rowcount |
+ Defines the total number of rows in a table , grid , or treegrid . |
+
aria-colindex |
+
+
|
+
aria-rowindex |
+
+
|
+
aria-colspan |
+ Defines the number of columns spanned by a cell or gridcell within a table , grid , or treegrid . |
+
aria-rowspan |
+ Defines the number of rows spanned by a cell or gridcell within a table , grid , or treegrid . |
+
aria-sort |
+ Indicates if items in a row or column are sorted in ascending or descending order. | +
aria-colcount
and aria-rowcount