spec/Overview.html 1.2059 2889 Support select.add(e) and select.options

Support select.add(e) and select.options.add(e) with no second argument.
(credit: cm) (whatwg r2889)

toggle
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2059.html#concept-select-toggle
HTMLOptionsCollection
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2059.html#htmloptionscollection-0
HTMLSelectElement
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2059.html#htmlselectelement

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2058&r2=1.2059&f=h
http://html5.org/tools/web-apps-tracker?from=2888&to=2889

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2058
retrieving revision 1.2059
diff -u -d -r1.2058 -r1.2059
--- Overview.html 20 Mar 2009 22:13:11 -0000 1.2058
+++ Overview.html 20 Mar 2009 23:04:15 -0000 1.2059
@@ -5534,7 +5534,7 @@
            attribute unsigned long <a href=#dom-htmloptionscollection-length title=dom-HTMLOptionsCollection-length>length</a>;
   [IndexGetter] <a href=#htmloptionelement>HTMLOptionElement</a> <a href=#dom-htmloptionscollection-item title=dom-HTMLOptionsCollection-item>item</a>(in unsigned long index);
   [NameGetter] Object <a href=#dom-htmloptionscollection-nameditem title=dom-HTMLOptionsCollection-namedItem>namedItem</a>(in DOMString name);
-  void <a href=#dom-htmloptionscollection-add title=dom-HTMLOptionsCollection-add>add</a>(in <a href=#htmlelement>HTMLElement</a> element, in <a href=#htmlelement>HTMLElement</a> before);
+  void <a href=#dom-htmloptionscollection-add title=dom-HTMLOptionsCollection-add>add</a>(in <a href=#htmlelement>HTMLElement</a> element, [Optional] in <a href=#htmlelement>HTMLElement</a> before);
   void <a href=#dom-htmloptionscollection-add title=dom-HTMLOptionsCollection-add>add</a>(in <a href=#htmlelement>HTMLElement</a> element, in long before);
   void <a href=#dom-htmloptionscollection-remove title=dom-HTMLOptionsCollection-remove>remove</a>(in long index);
 };</pre><dl class=domintro><dt><var title="">collection</var> . <code title=dom-HTMLOptionsCollection-length><a href=#dom-htmloptionscollection-length>length</a></code> [ = <var title="">value</var> ]</dt>
@@ -5559,16 +5559,16 @@
     <p>Returns null if no element with that ID could be found.</p>
    </dd>
 
-   <dt><var title="">collection</var> . <code title=dom-HTMLOptionsCollection-add><a href=#dom-htmloptionscollection-add>add</a></code>(<var title="">element</var>, <var title="">before</var>)</dt>
+   <dt><var title="">collection</var> . <code title=dom-HTMLOptionsCollection-add><a href=#dom-htmloptionscollection-add>add</a></code>(<var title="">element</var> [, <var title="">before</var> ] )</dt>
    <dd>
     <p>Inserts <var title="">element</var> before the node given by <var title="">before</var>.</p>
     <p>The <var title="">before</var> argument can be a number, in
     which case <var title="">element</var> is inserted before the item
     with that number, or an element from the collection, in which case
     <var title="">element</var> is inserted before that element.</p>
-    <p>If <var title="">before</var> is null or a number out of range,
-    then <var title="">element</var> will be added at the end of the
-    list.</p>
+    <p>If <var title="">before</var> is omitted, null, or a number out
+    of range, then <var title="">element</var> will be added at the
+    end of the list.</p>
     <p>This method will throw a <code><a href=#hierarchy_request_err>HIERARCHY_REQUEST_ERR</a></code>
     exception if <var title="">element</var> is an ancestor of the
     element into which it is to be inserted. If <var title="">element</var> is not an <code><a href=#the-option-element>option</a></code> or
@@ -28703,7 +28703,7 @@
            attribute unsigned long <a href=#dom-select-length title=dom-select-length>length</a>;
   [IndexGetter] any <a href=#dom-select-item title=dom-select-item>item</a>(in DOMString name);
   [NameGetter] any <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(in DOMString name);
-  void <a href=#dom-select-add title=dom-select-add>add</a>(in <a href=#htmlelement>HTMLElement</a> element, in <a href=#htmlelement>HTMLElement</a> before);
+  void <a href=#dom-select-add title=dom-select-add>add</a>(in <a href=#htmlelement>HTMLElement</a> element, [Optional] in <a href=#htmlelement>HTMLElement</a> before);
   void <a href=#dom-select-add title=dom-select-add>add</a>(in <a href=#htmlelement>HTMLElement</a> element, in long before);
   void <a href=#dom-select-remove title=dom-select-remove>remove</a>(in long index);
 
@@ -28858,16 +28858,17 @@
     <p>Returns null if no element with that ID could be found.</p>
    </dd>
 
-   <dt><var title="">select</var> . <code title=dom-select-add><a href=#dom-select-add>add</a></code>(<var title="">element</var>, <var title="">before</var>)</dt>
+   <dt><var title="">select</var> . <code title=dom-select-add><a href=#dom-select-add>add</a></code>(<var title="">element</var> [, <var title="">before</var> ])</dt>
    <dd>
     <p>Inserts <var title="">element</var> before the node given by <var title="">before</var>.</p>
     <p>The <var title="">before</var> argument can be a number, in
     which case <var title="">element</var> is inserted before the item
-    with that number, or an element from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in which case
-    <var title="">element</var> is inserted before that element.</p>
-    <p>If <var title="">before</var> is null or a number out of range,
-    then <var title="">element</var> will be added at the end of the
-    list.</p>
+    with that number, or an element from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in
+    which case <var title="">element</var> is inserted before that
+    element.</p>
+    <p>If <var title="">before</var> is omitted, null, or a number out
+    of range, then <var title="">element</var> will be added at the
+    end of the list.</p>
     <p>This method will throw a <code><a href=#hierarchy_request_err>HIERARCHY_REQUEST_ERR</a></code>
     exception if <var title="">element</var> is an ancestor of the
     element into which it is to be inserted. If <var title="">element</var> is not an <code><a href=#the-option-element>option</a></code> or

Received on Friday, 20 March 2009 23:06:50 UTC