Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create aria-rowindextext and aria-colindextext #994

Merged
merged 2 commits into from
Jun 25, 2019
Merged

Create aria-rowindextext and aria-colindextext #994

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0946ff2
Create aria-rowindextext and aria-colindextext
joanmarie Jun 12, 2019
a8fd9a0
Add a concrete example use case for aria-rowindextext
joanmarie Jun 12, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
85 changes: 83 additions & 2 deletions index.html
View file
Open in desktop
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