[html5] r7893 - [] (0) Fix HTMLSelectElement's collection-related IDL and non-normative prose. F [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Jun 4 13:12:25 PDT 2013


Author: ianh
Date: 2013-06-04 13:12:23 -0700 (Tue, 04 Jun 2013)
New Revision: 7893

Modified:
   complete.html
   index
   source
Log:
[] (0) Fix HTMLSelectElement's collection-related IDL and non-normative prose.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=21735
Affected topics: DOM APIs

Modified: complete.html
===================================================================
--- complete.html	2013-06-04 00:08:11 UTC (rev 7892)
+++ complete.html	2013-06-04 20:12:23 UTC (rev 7893)
@@ -50413,8 +50413,8 @@
 
   readonly attribute <a href=#htmloptionscollection>HTMLOptionsCollection</a> <a href=#dom-select-options title=dom-select-options>options</a>;
            attribute unsigned long <a href=#dom-select-length title=dom-select-length>length</a>;
-  getter <a href=#element>Element</a> <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
-  object <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
+  getter <a href=#element>Element</a>? <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
+  (<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>)? <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
   void <a href=#dom-select-add title=dom-select-add>add</a>((<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>) element, optional (<a href=#htmlelement>HTMLElement</a> or long)? before = null);
   void <a href=#dom-select-remove title=dom-select-remove>remove</a>(long index);
   <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>setter creator</a> void (unsigned long index, <a href=#htmloptionelement>HTMLOptionElement</a>? option);
@@ -50600,11 +50600,8 @@
    <dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>namedItem</a></code>(<var title="">name</var>)</dt>
    <dd>
 
-    <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
+    <p>Returns the first item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
 
-    <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all
-    those elements is returned.</p>
-
     <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
 
    </dd>

Modified: index
===================================================================
--- index	2013-06-04 00:08:11 UTC (rev 7892)
+++ index	2013-06-04 20:12:23 UTC (rev 7893)
@@ -50413,8 +50413,8 @@
 
   readonly attribute <a href=#htmloptionscollection>HTMLOptionsCollection</a> <a href=#dom-select-options title=dom-select-options>options</a>;
            attribute unsigned long <a href=#dom-select-length title=dom-select-length>length</a>;
-  getter <a href=#element>Element</a> <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
-  object <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
+  getter <a href=#element>Element</a>? <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
+  (<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>)? <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
   void <a href=#dom-select-add title=dom-select-add>add</a>((<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>) element, optional (<a href=#htmlelement>HTMLElement</a> or long)? before = null);
   void <a href=#dom-select-remove title=dom-select-remove>remove</a>(long index);
   <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>setter creator</a> void (unsigned long index, <a href=#htmloptionelement>HTMLOptionElement</a>? option);
@@ -50600,11 +50600,8 @@
    <dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>namedItem</a></code>(<var title="">name</var>)</dt>
    <dd>
 
-    <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
+    <p>Returns the first item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
 
-    <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all
-    those elements is returned.</p>
-
     <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
 
    </dd>

Modified: source
===================================================================
--- source	2013-06-04 00:08:11 UTC (rev 7892)
+++ source	2013-06-04 20:12:23 UTC (rev 7893)
@@ -1,4 +1,4 @@
-<!-- EDITOR NOTES  -*- mode: Text; fill-column: 100 -*-
+        <!-- EDITOR NOTES  -*- mode: Text; fill-column: 100 -*-
  !
  !   Adding a new element involves editing the following sections:
  !    - section for the element itself
@@ -55320,8 +55320,8 @@
 
   readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-options">options</span>;
            attribute unsigned long <span title="dom-select-length">length</span>;
-  getter <span>Element</span> <span title="dom-select-item">item</span>(unsigned long index);
-  object <span title="dom-select-namedItem">namedItem</span>(DOMString name);
+  getter <span>Element</span>? <span title="dom-select-item">item</span>(unsigned long index);
+  (<span>HTMLOptionElement</span> or <span>HTMLOptGroupElement</span>)? <span title="dom-select-namedItem">namedItem</span>(DOMString name);
   void <span title="dom-select-add">add</span>((<span>HTMLOptionElement</span> or <span>HTMLOptGroupElement</span>) element, optional (<span>HTMLElement</span> or long)? before = null);
   void <span title="dom-select-remove">remove</span>(long index);
   <span title="dom-HTMLOptionsCollection-setter">setter creator</span> void (unsigned long index, <span>HTMLOptionElement</span>? option);
@@ -55546,13 +55546,10 @@
    <dt><var title="">element</var> = <var title="">select</var> . <code title="dom-select-item">namedItem</code>(<var title="">name</var>)</dt>
    <dd>
 
-    <p>Returns the item with <span title="concept-id">ID</span> or <code
+    <p>Returns the first item with <span title="concept-id">ID</span> or <code
     title="attr-option-name">name</code> <var title="">name</var> from the <span
     title="concept-select-option-list">list of options</span>.</p>
 
-    <p>If there are multiple matching items, then a <code>NodeList</code> object containing all
-    those elements is returned.</p>
-
     <p>Returns null if no element with that <span title="concept-id">ID</span> could be found.</p>
 
    </dd>




More information about the Commit-Watchers mailing list