Create aria-rowindextext and aria-colindextext (#994)

Author: joanmarie

index.html

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