Skip to content

Commit

Permalink
revise meter authoring advice (#1129)
Browse files Browse the repository at this point in the history
* to have similar authoring expectations to HTML’s meter element, the authoring advice for the meter role is updated to remove the requirement for aria-valuemin and max, and instead indicate these attributes should have implicit defult values, similar to progressbar.
* removes aria-valuemax and min from the required states and properties row of the characteristics table, and moves them to an Implicit Value for Role row.
* Adds meter’s required aria-valuenow to the Fallback values for missing required attributes table
Co-authored-by: Carolyn MacLeod <[email protected]>
  • Loading branch information
scottaohara authored and jnurthen committed Apr 3, 2020
1 parent 5eccf5f commit 1bde3e1
Showing 1 changed file with 20 additions and 9 deletions.
29 changes: 20 additions & 9 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4550,9 +4550,14 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
<rdef>meter</rdef>
<div class="role-description">
<p>An <a>element</a> that represents a scalar measurement within a known range, or a fractional value. See related <rref>progressbar</rref>.</p>
<p>Authors MUST NOT use the <code>meter</code> role to represent a value whose minimum and maximum values are unknown. In addition, authors MUST use <pref>aria-valuemin</pref> and <pref>aria-valuemax</pref> to make the minimum and maximum values available to assistive technologies.</p>
<p>Authors MAY set <pref>aria-valuemin</pref> and <pref>aria-valuemax</pref> to indicate the minimum and maximum values for the <code>meter</code>. Otherwise, their implicit values follow the same rules as <code>&lt;input[type="range"]&gt;</code> in [[HTML]]:</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>
</ul>
<p>The value of <pref>aria-valuenow</pref> MUST NOT fall below or exceed the computed values of <code>aria-valuemin</code> and <code>aria-valuemax</code>, respectively.</p>
<p>Authors SHOULD NOT use the <code>meter</code> role to indicate progress; the <rref>progressbar</rref> role exists to address that need.</p>
<p class="note">At the present time, there are no <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> properties corresponding to the <code>low</code>, <code>optimum</code>, and <code>high</code> attributes supported on the <code>&lt;meter&gt;</code> element in [[HTML]]. The addition of these properties will be considered for ARIA version 1.3.</p>
<p class="note">Presently, there are no <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> properties corresponding to the <code>low</code>, <code>optimum</code>, and <code>high</code> attributes supported on the <code>&lt;meter&gt;</code> element in [[HTML]]. The addition of these properties will be considered for ARIA version 1.3.</p>
</div>
<table class="role-features">
<caption>Characteristics:</caption>
Expand Down Expand Up @@ -4593,13 +4598,7 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
</tr>
<tr>
<th class="role-required-properties-head">Required States and Properties:</th>
<td class="role-required-properties">
<ul>
<li><pref>aria-valuemax</pref></li>
<li><pref>aria-valuemin</pref></li>
<li><pref>aria-valuenow</pref></li>
</ul>
</td>
<td class="role-required-properties"><pref>aria-valuenow</pref></td>
</tr>
<tr>
<th class="role-properties-head" scope="row">Supported States and Properties:</th>
Expand Down Expand Up @@ -4629,6 +4628,13 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
<th class="role-presentational-inherited-head" scope="row">Inherits Presentational:</th>
<td class="role-presentational-inherited"> </td>
</tr>
<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>.
</td>
</tr>
</tbody>
</table>
</div>
Expand Down Expand Up @@ -12461,6 +12467,11 @@ <h3>States and Properties</h3>
<td><pref>aria-valuenow</pref></td>
<td><code>0</code></td>
</tr>
<tr>
<td><rref>meter</rref></td>
<td><pref>aria-valuenow</pref></td>
<td>A value matching the implicit or explicitly set <code>aria-valuemin</code>.</td>
</tr>
</tbody>
</table>
<p class="note">Implicit Values for non-required states and properties appear in the characteristics table for each role. These are not considered fallback values so are not included here.</p>
Expand Down

0 comments on commit 1bde3e1

Please sign in to comment.