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 @@

Exposing and Documenting Keyboard Shortcuts

Grid and Table Properties

- -

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.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PropertyDefinition
aria-colcountDefines the total number of columns in a table, grid, or treegrid.
aria-rowcountDefines the total number of rows in a table, grid, or treegrid.
aria-colindex +
    +
  • Defines a cell's position with respect to the total number of columns within a table, grid, or treegrid.
  • +
  • Note: Numbering starts with 1, not 0.
  • +
+
aria-rowindex +
    +
  • Defines a cell's position with respect to the total number of rows within a table, grid, or treegrid.
  • +
  • Note: Numbering starts with 1, not 0.
  • +
+
aria-colspanDefines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid.
aria-rowspanDefines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid.
aria-sortIndicates if items in a row or column are sorted in ascending or descending order.

Defining dimensions using aria-colcount and aria-rowcount