W3C home > Mailing lists > Public > public-html-commits@w3.org > January 2009

html5/spec Overview.html,1.1825,1.1826

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 13 Jan 2009 11:43:58 +0000
To: public-html-commits@w3.org
Message-Id: <E1LMhgc-0003SL-4B@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv13245

Modified Files:
	Overview.html 
Log Message:
Revamp how <select> handles enumeration, for better compatibility with WebIDL and, to some very limited extent, IE. Full compatibility with IE here is impossible without me losing my sanity. (whatwg r2656)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1825
retrieving revision 1.1826
diff -u -d -r1.1825 -r1.1826
--- Overview.html	13 Jan 2009 11:26:12 -0000	1.1825
+++ Overview.html	13 Jan 2009 11:43:55 -0000	1.1826
@@ -22872,7 +22872,7 @@
    <dd><code title=attr-select-size><a href=#attr-select-size>size</a></code></dd>
    <dt>DOM interface:</dt>
    <dd>
-<pre class=idl>[IndexGetter]
+<pre class=idl>[Callable=<a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>]
 interface <dfn id=htmlselectelement>HTMLSelectElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
            attribute boolean <a href=#dom-fe-autofocus title=dom-fe-autofocus>autofocus</a>;
            attribute boolean <a href=#dom-fe-disabled title=dom-fe-disabled>disabled</a>;
@@ -22885,6 +22885,8 @@
 
   readonly attribute <a href=#htmloptionscollection-0>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>;
+  [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, in long before);
   void <a href=#dom-select-remove title=dom-select-remove>remove</a>(in long index);
@@ -23000,18 +23002,22 @@
   DOM attribute must return an <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code>
   rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter matches the
   elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of
-  options</a>.<p>The <dfn id=dom-select-length title=dom-select-length><code>length</code></dfn> DOM
-  attribute, on getting and setting, must act like the <code title=dom-HTMLOptionsCollection-length><a href=#dom-htmloptionscollection-length>length</a></code> attribute on
-  the <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code> object returned by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute. Similarly, the
-  <dfn id=dom-select-add title=dom-select-add><code>add()</code></dfn> and <dfn id=dom-select-remove title=dom-select-remove><code>remove()</code></dfn> methods must
-  act like their namesake methods on that same
-  <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code> object.<p>The <span>indices of the supported indexed properties</span> at
-  any instant are the indicies supported by the object returned by the
+  options</a>.<p>The <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection is
+  also mirrored on the <code><a href=#htmlselectelement>HTMLSelectElement</a></code> object. The <dfn id=dom-select-length title=dom-select-length><code>length</code></dfn> DOM attribute
+  must return the number of nodes <a href=#represented-by-the-collection title="represented by the
+  collection">represented</a> by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection. The
+  <span>indices of the supported indexed properties</span> at any
+  instant are the indicies supported by the object returned by the
   <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute at that
-  instant. The value of the <span>corresponding indexed
-  property</span> whenever an indexed property is retrieved is the
-  value of the <span>corresponding indexed property</span> on the
-  object returned by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute.<p>The <dfn id=dom-select-selectedoptions title=dom-select-selectedOptions><code>selectedOptions</code></dfn>
+  instant. The <span>names of the supported named properties</span> at
+  any instant are the names supported by the object returned by the
+  <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute at that
+  instant.<p>The <dfn id=dom-select-item title=dom-select-item><code>item(<var title="">index</var>)</code></dfn> method must return the value
+  returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked
+  with the same argument.<p>The <dfn id=dom-select-nameditem title=dom-select-namedItem><code>namedItem(<var title="">index</var>)</code></dfn> method must return the value
+  returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked
+  with the same argument.<p>Similarly, the <dfn id=dom-select-add title=dom-select-add><code>add()</code></dfn> and <dfn id=dom-select-remove title=dom-select-remove><code>remove()</code></dfn> methods must
+  act like their namesake methods on that same <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.<p>The <dfn id=dom-select-selectedoptions title=dom-select-selectedOptions><code>selectedOptions</code></dfn>
   DOM attribute must return an <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at
   the <code><a href=#the-select-element>select</a></code> node, whose filter matches the elements in
   the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>
Received on Tuesday, 13 January 2009 11:44:08 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 13 January 2009 11:44:08 GMT