Skip to content

Commit 9653692

Browse files
authored
Add note to checkbox def (#1657)
Reference the native checkbox's strong native semantics / functionality and advise authors to use native features on the native element
1 parent 647ca11 commit 9653692

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

index.html

+3
Original file line numberDiff line numberDiff line change
@@ -1990,6 +1990,9 @@ <h2>Definition of Roles</h2>
19901990
<div class="role-description">
19911991
<p>A checkable input that has three possible <span>values</span>: <code>true</code>, <code>false</code>, or <code>mixed</code>.</p>
19921992
<p>The <sref>aria-checked</sref> <a>attribute</a> of a <code>checkbox</code> indicates whether the input is checked (<code>true</code>), unchecked (<code>false</code>), or represents a group of <a>elements</a> that have a mixture of checked and unchecked values (<code>mixed</code>). Many checkboxes do not use the <code>mixed</code> value, and thus are effectively boolean checkboxes.</p>
1993+
<p class="note">
1994+
Due to the strong native semantics of HTML's native checkbox, authors are advised against using <code>aria-checked</code> on an <code>input type=checkbox</code>. Rather, use the native <code>checked</code> attribute or the <code>indeterminate</code> IDL attribute to specify the checkbox's "checked" or "mixed" state, respectively.
1995+
</p>
19931996
</div>
19941997
<table class="role-features">
19951998
<caption>Characteristics:</caption>

0 commit comments

Comments
 (0)