Skip to content

Commit

Permalink
Create aria-rowindextext and aria-colindextext (#994)
Browse files Browse the repository at this point in the history
  • Loading branch information
@joanmarie
joanmarie authored Jun 25, 2019
1 parent 63ec695 commit 55a66bc
Showing 1 changed file with 83 additions and 2 deletions.
85 changes: 83 additions & 2 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1472,8 +1472,10 @@ <h2>Definition of Roles</h2>
<td class="role-properties">
<ul>
<li><pref>aria-colindex</pref></li>
<li><pref>aria-colindextext</pref></li>
<li><pref>aria-colspan</pref></li>
<li><pref>aria-rowindex</pref></li>
<li><pref>aria-rowindextext</pref></li>
<li><pref>aria-rowspan</pref></li>
</ul>
</td>
Expand Down Expand Up @@ -6352,6 +6354,7 @@ <h5>Presentational Roles Conflict Resolution</h5>
<li><pref>aria-level</pref></li>
<li><pref>aria-posinset</pref></li>
<li><pref>aria-rowindex</pref></li>
<li><pref>aria-rowindextext</pref></li>
<li><pref>aria-setsize</pref></li>
<li><sref>aria-selected</sref></li>
</ul>
Expand Down Expand Up @@ -9446,6 +9449,7 @@ <h3>Relationship Attributes</h3>
<li><pref>aria-activedescendant</pref></li>
<li><pref>aria-colcount</pref></li>
<li><pref>aria-colindex</pref></li>
<li><pref>aria-colindextext</pref></li>
<li><pref>aria-colspan</pref></li>
<li><pref>aria-controls</pref></li>
<li><pref>aria-describedby</pref></li>
Expand All @@ -9457,6 +9461,7 @@ <h3>Relationship Attributes</h3>
<li><pref>aria-posinset</pref></li>
<li><pref>aria-rowcount</pref></li>
<li><pref>aria-rowindex</pref></li>
<li><pref>aria-rowindextext</pref></li>
<li><pref>aria-rowspan</pref></li>
<li><pref>aria-setsize</pref></li>
</ul>
Expand Down Expand Up @@ -9826,7 +9831,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
<div class="property" id="aria-colindex">
<pdef>aria-colindex</pdef>
<div class="property-description">
<p>Defines an <a>element's</a> column index or position with respect to the total number of columns within a <rref>table</rref>, <rref>grid</rref>, or <rref>treegrid</rref>. See related <pref>aria-colcount</pref> and <pref>aria-colspan</pref>.</p>
<p>Defines an <a>element's</a> column index or position with respect to the total number of columns within a <rref>table</rref>, <rref>grid</rref>, or <rref>treegrid</rref>. See related <pref>aria-colindextext</pref>, <pref>aria-colcount</pref>, and <pref>aria-colspan</pref>.</p>
<p>If all of the columns are present in the <abbr title="Document Object Model">DOM</abbr>, it is not necessary to set this <a>attribute</a> as the <a>user agent</a> can automatically calculate the column index of each cell or <rref>gridcell</rref>. However, if only a portion of the columns is present in the <abbr title="Document Object Model">DOM</abbr> at a given moment, this attribute is needed to provide an explicit indication of the column of each cell or gridcell with respect to the full table.</p>
<p>Authors MUST set the <span>value</span> for <pref>aria-colindex</pref> to an integer greater than or equal to 1, greater than the <pref>aria-colindex</pref> value of any previous elements within the same row, and less than or equal to the number of columns in the full table. For a cell or gridcell which spans multiple columns, authors MUST set the value of <pref>aria-colindex</pref> to the start of the span.</p>
<p>If the set of columns which is present in the <abbr title="Document Object Model">DOM</abbr> is contiguous, and if there are no cells which span more than one row or column in that set, then authors MAY place <pref>aria-colindex</pref> on each row, setting the value to the index of the first column of the set. Otherwise, authors SHOULD place <pref>aria-colindex</pref> on all of the children or <a>owned</a> elements of each row.</p>
Expand Down Expand Up @@ -9938,6 +9943,42 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
</tbody>
</table>
</div>
<div class="property" id="aria-colindextext">
<pdef>aria-colindextext</pdef>
<div class="property-description">
<p>Defines a human readable text alternative of <pref>aria-colindex</pref>. See related <pref>aria-rowindextext</pref>.</p>
<p>Authors SHOULD only use <code>aria-colindextext</code> when the provided or calculated value of <pref>aria-colindex</pref> is not meaningful or does not reflect the displayed index, as is the case with spreadsheets and chess boards.</p>
<p>Authors SHOULD NOT use <code>aria-colindextext</code> as a replacement for <pref>aria-colindex</pref> because some assistive technologies rely upon the numeric column index for the purpose of keeping track of the user's position or providing alternative table navigation.</p>
<p class="note">Unlike <pref>aria-colindex</pref>, <code>aria-colindextext</code> is not a supported property of <rref>row</rref> because user agents have no way to reliably calculate <code>aria-colindextext</code> for the purpose of exposing its value on the <rref>cell</rref> or <rref>gridcell</rref>.</p>
</div>
<table class="property-features">
<caption>Characteristics:</caption>
<thead>
<tr>
<th scope="col">Characteristic</th>
<th scope="col">Value</th>
</tr>
</thead>
<tbody>
<tr>
<th class="property-related-head" scope="row">Related Concepts:</th>
<td class="property-related"> </td>
</tr>
<tr>
<th class="property-applicability-head" scope="row">Used in Roles:</th>
<td class="property-applicability">Placeholder</td>
</tr>
<tr>
<th class="property-descendants-head" scope="row">Inherits into Roles:</th>
<td class="property-descendants">Placeholder</td>
</tr>
<tr>
<th class="property-value-head" scope="row">Value:</th>
<td class="property-value"><a href="#valuetype_integer">string</a></td>
</tr>
</tbody>
</table>
</div>
<div class="property" id="aria-colspan">
<pdef>aria-colspan</pdef>
<div class="property-description">
Expand Down Expand Up @@ -11681,7 +11722,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
<div class="property" id="aria-rowindex">
<pdef>aria-rowindex</pdef>
<div class="property-description">
<p>Defines an <a>element's</a> row index or position with respect to the total number of rows within a <rref>table</rref>, <rref>grid</rref>, or <rref>treegrid</rref>. See related <pref>aria-rowcount</pref> and <pref>aria-rowspan</pref>.</p>
<p>Defines an <a>element's</a> row index or position with respect to the total number of rows within a <rref>table</rref>, <rref>grid</rref>, or <rref>treegrid</rref>. See related <pref>aria-rowindextext</pref>, <pref>aria-rowcount</pref>, and <pref>aria-rowspan</pref>.</p>
<p>If all of the rows are present in the <abbr title="Document Object Model">DOM</abbr>, it is not necessary to set this <a>attribute</a> as the <a>user agent</a> can automatically calculate the index of each row. However, if only a portion of the rows is present in the <abbr title="Document Object Model">DOM</abbr> at a given moment, this attribute is needed to provide an explicit indication of each row's position with respect to the full table.</p>
<p>Authors MUST set the <span>value</span> for <pref>aria-rowindex</pref> to an integer greater than or equal to 1, greater than the <pref>aria-rowindex</pref> value of any previous rows, and less than or equal to the number of rows in the full table. For a cell or gridcell which spans multiple rows, authors MUST set the value of <pref>aria-rowindex</pref> to the start of the span.</p>
<p>Authors SHOULD place <pref>aria-rowindex</pref> on each row. Authors MAY also place <pref>aria-rowindex</pref> on all of the children or <a>owned elements</a> of each row.</p>
Expand Down Expand Up @@ -11778,6 +11819,42 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
</tbody>
</table>
</div>
<div class="property" id="aria-rowindextext">
<pdef>aria-rowindextext</pdef>
<div class="property-description">
<p>Defines a human readable text alternative of <pref>aria-rowindex</pref>. See related <pref>aria-colindextext</pref>.</p>
<p>Authors SHOULD only use <code>aria-rowindextext</code> when the provided or calculated value of <pref>aria-rowindex</pref> is not meaningful or does not reflect the displayed index, as can be seen in the game Battleship.</p>
<p>Authors SHOULD NOT use <code>aria-rowindextext</code> as a replacement for <pref>aria-rowindex</pref> because some assistive technologies rely upon the numeric row index for the purpose of keeping track of the user's position or providing alternative table navigation.</p>
<p>Authors SHOULD place <code>aria-rowindextext</code> on each row. Authors MAY also place <code>aria-rowindextext</code> on all of the children or <a>owned elements</a> of each row.</p>
</div>
<table class="property-features">
<caption>Characteristics:</caption>
<thead>
<tr>
<th scope="col">Characteristic</th>
<th scope="col">Value</th>
</tr>
</thead>
<tbody>
<tr>
<th class="property-related-head" scope="row">Related Concepts:</th>
<td class="property-related"> </td>
</tr>
<tr>
<th class="property-applicability-head" scope="row">Used in Roles:</th>
<td class="property-applicability">Placeholder</td>
</tr>
<tr>
<th class="property-descendants-head" scope="row">Inherits into Roles:</th>
<td class="property-descendants">Placeholder</td>
</tr>
<tr>
<th class="property-value-head" scope="row">Value:</th>
<td class="property-value"><a href="#valuetype_integer">string</a></td>
</tr>
</tbody>
</table>
</div>
<div class="property" id="aria-rowspan">
<pdef>aria-rowspan</pdef>
<div class="property-description">
Expand Down Expand Up @@ -12457,6 +12534,7 @@ <h2>Interface Mixin <dfn>AriaAttributes</dfn></h2>
attribute DOMString? ariaChecked;
attribute DOMString? ariaColCount;
attribute DOMString? ariaColIndex;
attribute DOMString? ariaColIndexText;
attribute DOMString? ariaColSpan;
attribute FrozenArray&lt;Element&gt;? ariaControlsElements;
attribute DOMString? ariaCurrent;
Expand Down Expand Up @@ -12488,6 +12566,7 @@ <h2>Interface Mixin <dfn>AriaAttributes</dfn></h2>
attribute DOMString? ariaRoleDescription;
attribute DOMString? ariaRowCount;
attribute DOMString? ariaRowIndex;
attribute DOMString? ariaRowIndexText;
attribute DOMString? ariaRowSpan;
attribute DOMString? ariaSelected;
attribute DOMString? ariaSetSize;
Expand All @@ -12511,6 +12590,7 @@ <h2>ARIA Attribute Reflection</h2>
<tr><td><dfn>ariaChecked</dfn></td><td><sref>aria-checked</sref></td></tr>
<tr><td><dfn>ariaColCount</dfn></td><td><pref>aria-colcount</pref></td></tr>
<tr><td><dfn>ariaColIndex</dfn></td><td><pref>aria-colindex</pref></td></tr>
<tr><td><dfn>ariaColIndexText</dfn></td><td><pref>aria-colindextext</pref></td></tr>
<tr><td><dfn>ariaColSpan</dfn></td><td><pref>aria-colspan</pref></td></tr>
<tr><td><dfn>ariaControlsElements</dfn></td><td><pref>aria-controls</pref></td></tr>
<tr><td><dfn>ariaCurrent</dfn></td><td><sref>aria-current</sref></td></tr>
Expand Down Expand Up @@ -12542,6 +12622,7 @@ <h2>ARIA Attribute Reflection</h2>
<tr><td><dfn>ariaRoleDescription</dfn></td><td><pref>aria-roledescription</pref></td></tr>
<tr><td><dfn>ariaRowCount</dfn></td><td><pref>aria-rowcount</pref></td></tr>
<tr><td><dfn>ariaRowIndex</dfn></td><td><pref>aria-rowindex</pref></td></tr>
<tr><td><dfn>ariaRowIndexText</dfn></td><td><pref>aria-rowindextext</pref></td></tr>
<tr><td><dfn>ariaRowSpan</dfn></td><td><pref>aria-rowspan</pref></td></tr>
<tr><td><dfn>ariaSelected</dfn></td><td><sref>aria-selected</sref></td></tr>
<tr><td><dfn>ariaSetSize</dfn></td><td><pref>aria-setsize</pref></td></tr>
Expand Down

0 comments on commit 55a66bc

Please sign in to comment.