[html5] r8028 - [e] (0) Add an example of radio buttons. Fixing https://www.w3.org/Bugs/Public/s [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2013-07-03 14:31:06 -0700 (Wed, 03 Jul 2013)
New Revision: 8028

Modified:
   complete.html
   index
   source
Log:
[e] (0) Add an example of radio buttons.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=16029
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2013-07-03 20:56:57 UTC (rev 8027)
+++ complete.html	2013-07-03 21:31:06 UTC (rev 8028)
@@ -49883,7 +49883,31 @@
 
   </div>
 
+  <div class=example>
 
+   <p>For radio buttons, the <code title=attr-input-required><a href=#attr-input-required>required</a></code> attribute is
+   satisfied if any of the radio buttons in the <a href=#radio-button-group title="radio button group">group</a> is
+   selected. Thus, in the following example, any of the radio buttons can be checked, not just the
+   one marked as required:</p>
+
+   <pre><fieldset>
+ <legend>Did the movie pass the Bechdel test?</legend>
+ <p><label><input type="radio" name="bechdel" value="no-characters"> No, there are not even two female characters in the movie. </label>
+ <p><label><input type="radio" name="bechdel" value="no-names"> No, the female characters never talk to each other. </label>
+ <p><label><input type="radio" name="bechdel" value="no-topic"> No, when female characters talk to each other it's always about a male character. </label>
+ <p><label><input type="radio" name="bechdel" value="yes" <strong>required</strong>> Yes. </label>
+ <p><label><input type="radio" name="bechdel" value="unknown"> I don't know. </label>
+</fieldset></pre>
+
+   <p>To avoid confusion as to whether a <a href=#radio-button-group>radio button group</a> is required or not, authors
+   are encouraged to specify the attribute on all the radio buttons in a group. Indeed, in general,
+   authors are encouraged to avoid having radio button groups that do not have any initially checked
+   controls in the first place, as this is a state that the user cannot return to, and is therefore
+   generally considered a poor user interface.</p>
+
+  </div>
+
+
   <h6 id=the-multiple-attribute><span class=secno>4.10.7.3.5 </span>The <code title=attr-input-multiple><a href=#attr-input-multiple>multiple</a></code> attribute</h6>
 
   <p>The <dfn id=attr-input-multiple title=attr-input-multiple><code>multiple</code></dfn> attribute is a <a href=#boolean-attribute>boolean

Modified: index
===================================================================
--- index	2013-07-03 20:56:57 UTC (rev 8027)
+++ index	2013-07-03 21:31:06 UTC (rev 8028)
@@ -49883,7 +49883,31 @@
 
   </div>
 
+  <div class=example>
 
+   <p>For radio buttons, the <code title=attr-input-required><a href=#attr-input-required>required</a></code> attribute is
+   satisfied if any of the radio buttons in the <a href=#radio-button-group title="radio button group">group</a> is
+   selected. Thus, in the following example, any of the radio buttons can be checked, not just the
+   one marked as required:</p>
+
+   <pre><fieldset>
+ <legend>Did the movie pass the Bechdel test?</legend>
+ <p><label><input type="radio" name="bechdel" value="no-characters"> No, there are not even two female characters in the movie. </label>
+ <p><label><input type="radio" name="bechdel" value="no-names"> No, the female characters never talk to each other. </label>
+ <p><label><input type="radio" name="bechdel" value="no-topic"> No, when female characters talk to each other it's always about a male character. </label>
+ <p><label><input type="radio" name="bechdel" value="yes" <strong>required</strong>> Yes. </label>
+ <p><label><input type="radio" name="bechdel" value="unknown"> I don't know. </label>
+</fieldset></pre>
+
+   <p>To avoid confusion as to whether a <a href=#radio-button-group>radio button group</a> is required or not, authors
+   are encouraged to specify the attribute on all the radio buttons in a group. Indeed, in general,
+   authors are encouraged to avoid having radio button groups that do not have any initially checked
+   controls in the first place, as this is a state that the user cannot return to, and is therefore
+   generally considered a poor user interface.</p>
+
+  </div>
+
+
   <h6 id=the-multiple-attribute><span class=secno>4.10.7.3.5 </span>The <code title=attr-input-multiple><a href=#attr-input-multiple>multiple</a></code> attribute</h6>
 
   <p>The <dfn id=attr-input-multiple title=attr-input-multiple><code>multiple</code></dfn> attribute is a <a href=#boolean-attribute>boolean

Modified: source
===================================================================
--- source	2013-07-03 20:56:57 UTC (rev 8027)
+++ source	2013-07-03 21:31:06 UTC (rev 8028)
@@ -54672,7 +54672,31 @@
 
   </div>
 
+  <div class="example">
 
+   <p>For radio buttons, the <code title="attr-input-required">required</code> attribute is
+   satisfied if any of the radio buttons in the <span title="radio button group">group</span> is
+   selected. Thus, in the following example, any of the radio buttons can be checked, not just the
+   one marked as required:</p>
+
+   <pre><fieldset>
+ <legend>Did the movie pass the Bechdel test?</legend>
+ <p><label><input type="radio" name="bechdel" value="no-characters"> No, there are not even two female characters in the movie. </label>
+ <p><label><input type="radio" name="bechdel" value="no-names"> No, the female characters never talk to each other. </label>
+ <p><label><input type="radio" name="bechdel" value="no-topic"> No, when female characters talk to each other it's always about a male character. </label>
+ <p><label><input type="radio" name="bechdel" value="yes" <strong>required</strong>> Yes. </label>
+ <p><label><input type="radio" name="bechdel" value="unknown"> I don't know. </label>
+</fieldset></pre>
+
+   <p>To avoid confusion as to whether a <span>radio button group</span> is required or not, authors
+   are encouraged to specify the attribute on all the radio buttons in a group. Indeed, in general,
+   authors are encouraged to avoid having radio button groups that do not have any initially checked
+   controls in the first place, as this is a state that the user cannot return to, and is therefore
+   generally considered a poor user interface.</p>
+
+  </div>
+
+
   <h6>The <code title="attr-input-multiple">multiple</code> attribute</h6>
 
   <p>The <dfn title="attr-input-multiple"><code>multiple</code></dfn> attribute is a <span>boolean