Action-1293 Proposal

for role="row" add aria-rowindex and aria-rsize
for role="cell" and gridcell add aria-colindex, and aria-csize

aria-colindex (property)


Defines an element's cell or gridcell column number or position in the
current set of columns table, grid, or treegrid. See related aria-csize.


This property is not automatically caldulated by the user agent. The
default value is -1 which means indeterminant.


The following example shows columns 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-rowindex (property)

Defines a element's row number or position in the current set of rows
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 set size and position for each item. 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-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>

aria-csize (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.


This property is not automatically caldulated by the user agent. The
default value is -1 which means indeterminate.


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-rsize (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 set size and position for each item. 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 Monday, 9 March 2015 15:21:49 UTC