Skip to content

Commit

Permalink
Action-2021: Update text regarding implicit values for spinbutton
Browse files Browse the repository at this point in the history
* Default for aria-valuemin is that there is no minimum value.
* Default for aria-valuemax is that there is no maximum value.
* Default for aria-valuenow is 0.
  • Loading branch information
joanmarie committed Mar 10, 2016
1 parent 659a27c commit 9fce35e
Showing 1 changed file with 8 additions and 9 deletions.
17 changes: 8 additions & 9 deletions aria/aria.html
Original file line number Diff line number Diff line change
Expand Up @@ -6171,13 +6171,11 @@ <h5 id="role-presentation-ednote-none">Editorial Note regarding the ARIA 1.1 <rr
<p>A form of <rref>range</rref> that expects the user to select from among discrete choices.</p>
<p>A <code>spinbutton</code> typically allows the user to select from the given range through the use of an up and down button on the keyboard. Visibly, the current value is incremented or decremented until a maximum or minimum value is reached. Authors SHOULD ensure this functionality is accomplished programmatically through the use of <kbd>up</kbd> and <kbd>down</kbd> arrows on the keyboard.</p>
<p>Although a <code>spinbutton</code> is similar in appearance to many presentations of <code>select</code>, it is advisable to use <code>spinbutton</code> when working with known ranges (especially in the case of large ranges) as opposed to distinct options. For example, a <code>spinbutton</code> representing a range from 1 to 1,000,000 would provide much better performance than a <code>select</code> <a>widget</a> representing the same values.</p>
<p>Authors MUST set the <pref>aria-valuemin</pref>, <pref>aria-valuemax</pref>, and <pref>aria-valuenow</pref> attributes. If missing, their implicit values follow the same rules as the <a href="http://www.w3.org/TR/html5/forms.html#range-state-%28type=range%29" title="Range state">HTML range input type</a>:</p>
<p>Authors MUST set the <pref>aria-valuenow</pref> attribute. Authors SHOULD set the <pref>aria-valuemin</pref> attribute when there is a minimum value, and the <pref>aria-valuemax</pref> attribute when there is a maximum value. If missing or not a <a href="#valuetype_number">number</a>, the implicit values of these attributes are as follows:</p>
<ul>
<li>If <code>aria-valuemin</code> is missing or not a <a href="#valuetype_number">number</a>, it defaults to 0 (zero). </li>
<li>If <code>aria-valuemax</code> is missing or not a <a href="#valuetype_number">number</a>, it defaults to 100. </li>
<li>If <code>aria-valuenow</code> is missing or not a <a href="#valuetype_number">number</a>, it defaults to the value half way between <code>aria-valuemin</code> and <code>aria-valuemax</code>. </li>
<li>If <code>aria-valuenow</code> is present but less than <code>aria-valuemin</code>, it defaults to the value of <code>aria-valuemin</code>. </li>
<li>If <code>aria-valuenow</code> is present but greater than <code>aria-valuemax</code>, it defaults to the value of <code>aria-valuemax</code>. </li>
<li>The implicit value of <code>aria-valuemin</code> is that there is no minimum value.</li>
<li>The implicit value of <code>aria-valuemax</code> is that there is no maximum value.</li>
<li>The implicit value of <code>aria-valuenow</code> is <code>0</code>.</li>
</ul>
</div>
<table class="role-features">
Expand Down Expand Up @@ -6268,9 +6266,9 @@ <h5 id="role-presentation-ednote-none">Editorial Note regarding the ARIA 1.1 <rr
<tr>
<th class="implicit-values-head" scope="row">Implicit Value for Role:</th>
<td class="implicit-values">
Default for <pref>aria-valuemin</pref> is <code class="default">0</code>. <br/>
Default for <pref>aria-valuemax</pref> is <code class="default">100</code>. <br/>
Default for <pref>aria-valuenow</pref> is half way between <code class="default">aria-valuemax</code> and <code class="default">aria-valuemin</code>.
Default for <pref>aria-valuemin</pref> is that there is no minimum value.<br/>
Default for <pref>aria-valuemax</pref> is that there is no maximum value.<br/>
Default for <pref>aria-valuenow</pref> is <code>0</code>.<br/>
</td>
</tr>
</tbody>
Expand Down Expand Up @@ -10882,6 +10880,7 @@ <h2>Substantive changes since the <a href="http://www.w3.org/TR/2015/WD-wai-aria
<li>25-Feb-2016: Added <pref>aria-details</pref> attribute.</li>
<li>25-Feb-2016: Removed <code>aria-describedat</code> which has been made obsolete by <pref>aria-details</pref>.</li>
<li>29-Feb-2016: Added statement that authors MUST ensure <pref>aria-errormessage</pref> content is not hidden and is included in a container that exposes the content to the user.</li>
<li>10-Mar-2016: Updated text regarding implicit values for <rref>spinbutton</rref>: Default for <pref>aria-valuenow</pref> is <code>0</code>. There is no minimum value for <pref>aria-valuemin</pref> and no maximum value for <pref>aria-valuemax</pref>.</li>
</ul>
</section>
<section>
Expand Down

0 comments on commit 9fce35e

Please sign in to comment.