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

html5/spec Overview.html,1.1811,1.1812

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 13 Jan 2009 00:21:07 +0000
To: public-html-commits@w3.org
Message-Id: <E1LMX1n-0004eD-4U@lionel-hutz.w3.org>

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

Modified Files:
	Overview.html 
Log Message:
Define Document's [[Get]]ter. (credit: sp) (whatwg r2642)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1811
retrieving revision 1.1812
diff -u -d -r1.1811 -r1.1812
--- Overview.html	12 Jan 2009 03:30:00 -0000	1.1811
+++ Overview.html	13 Jan 2009 00:21:04 -0000	1.1812
@@ -8,7 +8,7 @@
    <p><a href=http://www.w3.org/><img alt=W3C height=48 src=http://www.w3.org/Icons/w3c_home width=72></a></p>
    <h1>HTML 5</h1>
    <h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->12 January 2009</h2>
+   <h2 class="no-num no-toc" id=editor-s-draft-date-zzz-9-june-2008><!-- "W3C Working Draft" --> Editor's Draft <!--ZZZ-->13 January 2009</h2>
    <dl><!-- ZZZ: update the month/day
     <dt>This Version:</dt>
     <dd><a href="http://www.w3.org/TR/2009/WD-html5-20090610/">http://www.w3.org/TR/2009/WD-html5-20090610/</a></dd>
@@ -97,7 +97,7 @@
   specification's progress along the W3C Recommendation
   track.
   <!--ZZZ:-->
-  This specification is the 12 January 2009 <!--ZZZ "Working Draft"-->Editor's Draft.
+  This specification is the 13 January 2009 <!--ZZZ "Working Draft"-->Editor's Draft.
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href=http://www.whatwg.org/>WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -4872,7 +4872,8 @@
   <code>SVGDocument</code>.<p class=note>Because the <code><a href=#htmldocument>HTMLDocument</a></code> interface is
   now obtained using binding-specific casting methods instead of
   simply being the primary interface of the document object, it is no
-  longer defined as inheriting from <code>Document</code>.<pre class=idl>interface <dfn id=htmldocument>HTMLDocument</dfn> {
+  longer defined as inheriting from <code>Document</code>.<pre class=idl>[<a href=#dom-document-nameditem title=dom-document-namedItem>NameGetter</a>]
+interface <dfn id=htmldocument>HTMLDocument</dfn> {
   // <a href=#resource-metadata-management>resource metadata management</a>
   [PutForwards=href] readonly attribute <a href=#location>Location</a> <a href=#dom-document-location title=dom-document-location>location</a>;
   readonly attribute DOMString <a href=#dom-document-url title=dom-document-URL>URL</a>;
@@ -5227,7 +5228,41 @@
 >         * xGetParentElementByClassName(rootElement, className, tagName) -
 > Navigates upwards until we hit a parent element with the given class name and
 > optional tag name.
---><p class=note>The <code title=dom-document-dir><a href=#dom-document-dir>dir</a></code>
+--><p>The <code><a href=#htmldocument>HTMLDocument</a></code> interface <span title="support
+  named properties">supports named properties</span>. The <span>names
+  of the supported named properties</span> at any moment consist of
+  the values of the <code title=attr-name>name</code> content
+  attributes of all the <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-embed-element>embed</a></code>,
+  <code><a href=#the-form-element>form</a></code>, <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, and
+  <code><a href=#the-object-element>object</a></code> elements in the <code>Document</code> that have
+  <code title=attr-name>name</code> content attributes, and the
+  values of the <code title=attr-id><a href=#the-id-attribute>id</a></code> content attributes of
+  all the <code><a href=#the-applet-element>applet</a></code> and <code><a href=#the-object-element>object</a></code> elements in the
+  <code>Document</code> that have <code title=attr-id><a href=#the-id-attribute>id</a></code>
+  content attributes.<p>When <dfn id=dom-document-nameditem title=dom-document-namedItem>the
+  <code>HTMLDocument</code> object is indexed for property
+  retrieval</dfn> using a name <var title="">name</var>, then: if the
+  list of <a href=#dom-document-nameditem-filter title=dom-document-namedItem-filter>named
+  elements</a> with the name <var title="">name</var> in the
+  <code>Document</code> <!-- There will be at least one such element,
+  by definition. (If there wasn't, then this algorithm wouldn't have
+  been invoked by WebIDL.) --> has only one element, then that element
+  must be the value returned; otherwise the value returned must be an
+  <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at the <code>Document</code>
+  node, whose filter matches only <a href=#dom-document-nameditem-filter title=dom-document-namedItem-filter>named elements</a> with the
+  name <var title="">name</var>.</p><!-- the same one each time is
+  returned, because of the rule under collections --><p><dfn id=dom-document-nameditem-filter title=dom-document-nameditem-filter>Named elements</dfn>
+  with the name <var title="">name</var> are those that are
+  either:<ul><li><code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-form-element>form</a></code>,
+   <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, or <code><a href=#the-object-element>object</a></code>
+   elements that have a <code title=attr-name>name</code> content
+   attribute whose value is <var title="">name</var>, or</li>
+
+   <li><code><a href=#the-applet-element>applet</a></code> or <code><a href=#the-object-element>object</a></code> elements that have a
+   <code title=attr-id><a href=#the-id-attribute>id</a></code> content attribute whose value is
+   <var title="">name</var>.</li>
+
+  </ul><p class=note>The <code title=dom-document-dir><a href=#dom-document-dir>dir</a></code>
   attribute on the <code><a href=#htmldocument>HTMLDocument</a></code> interface is defined
   along with the <code title=attr-dir><a href=#the-dir-attribute>dir</a></code> content
   attribute.<h3 id=elements><span class=secno>3.3 </span>Elements</h3><h4 id=semantics-0><span class=secno>3.3.1 </span>Semantics</h4><p>Elements, attributes, and attribute values in HTML are defined
Received on Tuesday, 13 January 2009 00:21:15 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 13 January 2009 00:21:16 GMT