ISSUE-587/ACTION-1548: Add the aria-current attribute to the specific…

…ation

aria/aria.html

@@ -7993,6 +7993,88 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
 			</table>
 		</div>
 		<hr/>
+		<div class="state" id="aria-current">
+			<sdef>aria-current</sdef>
+			<div class="state-description">
+				<p>[ARIA 1.1] Indicates the <a title="element">element</a> that represents the current item within a container or set of related elements.</p>
+				<p>The <aref>aria-current</aref> <a>attribute</a> is an enumerated type. Any <a>value</a> not included in the list of allowed values must be treated by <a title="user agent">user agents</a> as if the value <code>true</code> had been provided. If the attribute is not present or its value is an empty string, the default value of <code>false</code> applies and the <aref>aria-current</aref> <a>state</a> must not be exposed by user agents or <a>assistive technologies</a>.</p>
+				<p>The <aref>aria-current</aref> attribute is used when an element within a set of related elements is visually styled to indicate it is the current item in the set. For example:</p>
+				<ul>
+					<li>The <code>page</code> token could be used to indicate a link within a set of pagination links, where the link is visually styled to represent the currently-displayed page.</li>
+					<li>The <code>step</code> token could be used to indicate a link within a step indicator for a step-based process, where the link is visually styled to represent the current step.</li>
+					<li>The <code>location</code> token could be used to indicate the image that is visually highlighted as the current component of a flowchart.</li>
+					<li>The <code>date</code> token could be used to indicate the current date within a calendar.</li>
+					<li>The <code>time</code> token could be used to indicate the current time within a timetable.</li>
+				</ul>
+				<p class="note">The <aref>aria-current</aref> attribute is similar to the <sref>aria-selected</sref> attribute, but there are important differences. For example in a <rref>listbox</rref> <a>widget</a> for choosing between pages of search results, <aref>aria-current</aref> would be used to indicate the option representing the currently displayed page of results, whereas <sref>aria-selected</sref> would be used to indicate the page of results the user had selected to be displayed next.</p>
+			<table class="state-features">
+				<caption>Characteristics:</caption>
+				<thead>
+					<tr>
+						<th scope="col">Characteristic</th>
+						<th scope="col">Value</th>
+					</tr>
+				</thead>
+				<tbody>
+					<tr>
+						<th class="state-related-head" scope="row">Related Concepts:</th>
+						<td class="state-related"> </td>
+					</tr>
+					<tr>
+						<th class="state-applicability-head" scope="row">Used in Roles:</th>
+						<td class="state-applicability">All elements of the base markup</td>
+					</tr>
+					<tr>
+						<th class="state-descendants-head" scope="row">Inherits into Roles:</th>
+						<td class="state-descendants">Placeholder</td>
+					</tr>
+					<tr>
+						<th class="state-value-head" scope="row">Value:</th>
+						<td class="property-value"><a href="#valuetype_token">token</a></td>
+					</tr>
+				</tbody>
+			</table>
+			<table class="value-descriptions">
+				<caption>Values:</caption>
+				<thead>
+					<tr>
+						<th scope="col">Value</th>
+						<th scope="col">Description</th>
+					</tr>
+				</thead>
+				<tbody>
+					<tr>
+						<th class="value-name" scope="row">page</th>
+						<td class="value-description">Represents the current page within a set of pages.</td>
+					</tr>
+					<tr>
+						<th class="value-name" scope="row">step</th>
+						<td class="value-description">Represents the current step within a process.</td>
+					</tr>
+					<tr>
+						<th class="value-name" scope="row">location</th>
+						<td class="value-description">Represents the current location within an environment or context.</td>
+					</tr>
+					<tr>
+						<th class="value-name" scope="row">date</th>
+						<td class="value-description">Represents the current date within a collection of dates.</td>
+					</tr>
+					<tr>
+						<th class="value-name" scope="row">time</th>
+						<td class="value-description">Represents the current time within a set of times.</td>
+					</tr>
+					<tr>
+						<th class="value-name" scope="row">true</th>
+						<td class="value-description">Represents the current item within a set.</td>
+					</tr>
+					<tr>
+						<th class="value-name" scope="row"><strong class="default">false (default)</strong></th>
+						<td class="value-description">Does not represent the current item within a set.</td>
+					</tr>
+				</tbody>
+			</table>
+		</div>
+		<hr/>
 		<div class="property" id="aria-describedat">
 			<pdef>aria-describedat</pdef>
 			<div class="property-description">
@@ -9898,6 +9980,7 @@ <h2>Substantive changes since the <a href="http://www.w3.org/TR/2013/WD-wai-aria
 			<li>9-Dec-2014: Removed legacy author requirements from aria-hidden that were once relevant to DOM-based screen readers.</li>
 			<li>14-Jan-2015: Added <rref>searchbox</rref> role.</li>
 			<li>15-Jan-2015: Added <rref>switch</rref> role.</li>
+			<li>22-Jan-2015: Added <sref>aria-current</sref> attribute.</li>
 			<!-- EdNote: After each WD publish, move contents of this list into the next one below. -->
 		</ul>
 	</section>