You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
closes#2382
and is related to #2344 / #2369
This PR adds aria-valuetext as a supported property for the combobox role.
the `aria-valuetext` definition is slightly updated to indicate that the attribute can be used on other supported roles. I'm not sure if we want to do any further updates to that section in this PR - or if that really should be handled in a larger PR to resolve#711
Copy file name to clipboardexpand all lines: index.html
+4-2
Original file line number
Diff line number
Diff line change
@@ -2074,6 +2074,7 @@ <h2>Definition of Roles</h2>
2074
2074
The value of a <code>combobox</code> is represented by one of the following:
2075
2075
</p>
2076
2076
<ul>
2077
+
<li>If the <code>aria-valuetext</code> attribute is specified on the element with the <code>combobox</code> role, the value of the attribute is the value of the <code>combobox</code> element.</li>
2077
2078
<li>If the <code>combobox</code> element is a host language element that provides a value, such as an HTML <code>input</code> element, the value of the combobox is the value of that element.</li>
2078
2079
<li>Otherwise, the value of the <code>combobox</code> is represented by its descendant elements and can be determined using the same method used to compute the name of a <rref>button</rref> from its descendant content.</li>
2079
2080
</ul>
@@ -2148,14 +2149,15 @@ <h2>Definition of Roles</h2>
2148
2149
<th class="role-properties-head" scope="row">Supported States and Properties:</th>
2149
2150
<td class="role-properties">
2150
2151
<ul>
2151
-
<li><pref>aria-activedescendant</pref></li>
2152
+
<li><pref>aria-activedescendant</pref></li>
2152
2153
<li><pref>aria-autocomplete</pref></li>
2153
2154
<li><pref>aria-controls</pref></li>
2154
2155
<li><pref>aria-errormessage</pref></li>
2155
2156
<li><pref>aria-haspopup</pref></li>
2156
2157
<li><sref>aria-invalid</sref></li>
2157
2158
<li><pref>aria-readonly</pref></li>
2158
2159
<li><pref>aria-required</pref></li>
2160
+
<li><pref>aria-valuetext</pref></li>
2159
2161
</ul>
2160
2162
</td>
2161
2163
</tr>
@@ -13300,7 +13302,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
13300
13302
<div class="property" id="aria-valuetext">
13301
13303
<pdef>aria-valuetext</pdef>
13302
13304
<div class="property-description">
13303
-
<p><a>Defines</a> the human readable text alternative of <pref>aria-valuenow</pref> for a range <a>widget</a>.</p>
13305
+
<p><a>Defines</a> the human readable text alternative of <pref>aria-valuenow</pref> for a range <a>widget</a>, or other widget roles which support the attribute.</p>
13304
13306
<p>This property is used, for example, on a range widget such as a slider or progress bar.</p>
13305
13307
<p>If the <pref>aria-valuetext</pref> attribute is set, authors SHOULD also set the <pref>aria-valuenow</pref> attribute, unless that value is unknown (for example, on an indeterminate <rref>progressbar</rref>).</p>
13306
13308
<p>Authors SHOULD only set the <pref>aria-valuetext</pref> attribute when the rendered value cannot be meaningfully represented as a number. For example, a slider might have rendered values of <code>small</code>, <code>medium</code>, and <code>large</code>. In this case, the values of <pref>aria-valuenow</pref> could range from 1 through 3, which indicate the position of each value in the value space, but the <pref>aria-valuetext</pref> would be one of the strings: <code>small</code>, <code>medium</code>, or <code>large</code>. If the <pref>aria-valuetext</pref> attribute is absent, the <a>assistive technologies</a> will rely solely on the <pref>aria-valuenow</pref> attribute for the current value.</p>
0 commit comments