Skip to content

Commit ca98d5f

Browse files
authored
Allow aria-valuetext for use with combobox role
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
1 parent a2d34fe commit ca98d5f

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

index.html

+4-2
Original file line numberDiff line numberDiff line change
@@ -2074,6 +2074,7 @@ <h2>Definition of Roles</h2>
20742074
The value of a <code>combobox</code> is represented by one of the following:
20752075
</p>
20762076
<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>
20772078
<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>
20782079
<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>
20792080
</ul>
@@ -2148,14 +2149,15 @@ <h2>Definition of Roles</h2>
21482149
<th class="role-properties-head" scope="row">Supported States and Properties:</th>
21492150
<td class="role-properties">
21502151
<ul>
2151-
<li><pref>aria-activedescendant</pref></li>
2152+
<li><pref>aria-activedescendant</pref></li>
21522153
<li><pref>aria-autocomplete</pref></li>
21532154
<li><pref>aria-controls</pref></li>
21542155
<li><pref>aria-errormessage</pref></li>
21552156
<li><pref>aria-haspopup</pref></li>
21562157
<li><sref>aria-invalid</sref></li>
21572158
<li><pref>aria-readonly</pref></li>
21582159
<li><pref>aria-required</pref></li>
2160+
<li><pref>aria-valuetext</pref></li>
21592161
</ul>
21602162
</td>
21612163
</tr>
@@ -13300,7 +13302,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
1330013302
<div class="property" id="aria-valuetext">
1330113303
<pdef>aria-valuetext</pdef>
1330213304
<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>
1330413306
<p>This property is used, for example, on a range widget such as a slider or progress bar.</p>
1330513307
<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>
1330613308
<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

Comments
 (0)