- From: Richard Schwerdtfeger <schwer@us.ibm.com>
- Date: Sun, 15 Mar 2015 12:07:56 -0500
- To: PF <public-pfwg@w3.org>
Thank you for the feedback. I updated the proposal based on feedback from
the group. I addressed these issues:
- consistent abbeviated counts and indexes. These could be entered a lot
depending on the size of the grid or table
- modified aria-cindex to be automatically calculated
- fixed a typo on calculated
- changed csize to be automatically calculated
- adjusted the aria-rindex and aria-cindex definitions to be clearer based
on feedback
for role="row" add aria-rcount and aria-rsize
for role="cell" and gridcell add aria-ccount, and aria-ccount,
aria-rcount, and aria-aria-rsize
aria-cindex (property)
Defines an element's cell or gridcell column index with respect to the
total number of columns within the table, grid, or treegrid. See related
aria-csize.
If all items in a set are present in the document structure, it is not
necessary to set this attribute, as the user agent can automatically
calculate the column index of each cell or gridcell. However, if only a
portion of the set is present in the document structure at a given moment,
this property is needed to provide an explicit indication of an element's
position.
The following example shows columns 5 through 8 in a set of 16.
<table role="grid">
<row>
<td role="gridcell" aria-cindex="5" aria-csize="16">A</td>
<td role="gridcell" aria-cindex="6" aria-csize="16">B</td>
<td role="gridcell" aria-cindex="7" aria-csize="16">C</td>
<td role="gridcell" aria-cindex="8" aria-csize="16">D</td>
</row>
...
</table>
aria-rindex (property)
Defines a element's row index or position with respec to the total number
rows within the
table, grid, or treegrid. It is not required if all row elements in the
set
are present in the DOM. See related aria-rsize
If all items in a set are present in the document structure, it is not
necessary to set this attribute, as the user agent can automatically
calculate the row index. However, if only a
portion of the set is present in the document structure at a given moment,
this property is needed to provide an explicit indication of an element's
position.
When applied to an element having a role of "row" the user agent must
expose the proprety to assistive technologies on all descendant cells and
gridcells in addition to the row it is applied to.
The following example shows rows 3 through 5 in a set of 5.
<table>
<row aria-rindex="3" aria-rsize="5">
<td>A</td>
<td>B</td>
<td>C</td>
</row>
<row aria-rindex="4" aria-rsize="5">
<td>A</td>
<td>B</td>
<td>C</td>
</row>
<row aria-rowindex="5" aria-rsize="5">
<td>A</td>
<td>B</td>
<td>C</td>
</row>
</table>
aria-ccount (property)
Defines the number of columns in the current table or grid's set of
columns.
This property is marked on the members of a set, not the container element
that collects the members of the set. To orient the user by saying an
element is "item X out of Y," the assistive technologies would use X equal
to the aria-colindex attribute and aria-csize equal to the aria-colsize
attribute.
If all items in a set are present in the document structure, it is not
necessary to set this property, as the user agent can automatically
calculate the number of number of columns. However, if only a
portion of the set is present in the document structure at a given moment
(in order to reduce document size), this property is needed to provide an
explicit indication of set size.
The following example shows items 5 through 8 in a set of 16.
<table role="grid">
<row>
<td role="gridcell" aria-colindex="5" aria-csize="16">A</td>
<td role="gridcell" aria-colindex="6" aria-csize="16">B</td>
<td role="gridcell" aria-colindex="7" aria-csize="16">C</td>
<td role="gridcell" aria-colindex="8" aria-csize="16">D</td>
</row>
...
</table>
aria-rcount (property)
Defines the number of rows in the current set of rows within a table,
grid,
or treegrid. Not required if all elements in the set are present in the
DOM. See related aria-posinset.
This property is marked on rows, or cells or gridcells contained within
the
containing row. To orient the user by saying an element is "item X out of
Y," the assistive technologies would use X equal to the aria-rowindex
attribute and Y equal to the aria-rsize attribute.
If all items in a set are present in the document structure, it is not
necessary to set this property, as the user agent can automatically
calculate the number rows. However, if only a
portion of the set is present in the document structure at a given moment
(in order to reduce document size), this property is needed to provide an
explicit indication of set size.
When applied to an element having a role of "row" the user agent must
expose the proprety to assistive technologies on all descendant cells and
gridcells unless overridden by applying the property directly to a
descendant cell or gridcell.
The following example shows rows 3 through 5 in a set of 5.
<table>
<row aria-rowindex="3" aria-rsize="5">
<td>A</td>
<td>B</td>
<td>C</td>
</row>
<row aria-rowindex="4" aria-rsize="5">
<td>A</td>
<td>B</td>
<td>C</td>
</row>
<row aria-rowindex="5" aria-rsize="5">
<td>A</td>
<td>B</td>
<td>C</td>
</row>
</table>
Note: need to coordinate with Steve Faulkner new native host language
semantics for TD and Table elements.
Rich Schwerdtfeger
Received on Sunday, 15 March 2015 17:19:39 UTC