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

html5/spec Overview.html,1.1815,1.1816

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 13 Jan 2009 07:46:44 +0000
To: public-html-commits@w3.org
Message-Id: <E1LMdz2-0005uI-Kz@lionel-hutz.w3.org>

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

Modified Files:
	Overview.html 
Log Message:
Add <embed> to the HTMLCollection nmedItem() rules. Made the HTMLDocument NameGetter override builtins. Made it return Window objects instead of <iframe>s. Added a similar NameGetter for Window. Fixed typos, added clarifications, fixed cross-reference issues. (whatwg r2646)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1815
retrieving revision 1.1816
diff -u -d -r1.1815 -r1.1816
--- Overview.html	13 Jan 2009 00:47:43 -0000	1.1815
+++ Overview.html	13 Jan 2009 07:46:41 -0000	1.1816
@@ -581,7 +581,8 @@
      <li><a href=#security-2><span class=secno>5.2.1 </span>Security</a></li>
      <li><a href=#apis-for-creating-and-navigating-browsing-contexts-by-name><span class=secno>5.2.2 </span>APIs for creating and navigating browsing contexts by name</a></li>
      <li><a href=#accessing-other-browsing-contexts><span class=secno>5.2.3 </span>Accessing other browsing contexts</a></li>
-     <li><a href=#garbage-collection-and-browsing-contexts><span class=secno>5.2.4 </span>Garbage collection and browsing contexts</a></ol></li>
+     <li><a href=#garbage-collection-and-browsing-contexts><span class=secno>5.2.4 </span>Garbage collection and browsing contexts</a></li>
+     <li><a href=#named-access-on-the-window-object><span class=secno>5.2.5 </span>Named access on the <code>Window</code> object</a></ol></li>
    <li><a href=#origin><span class=secno>5.3 </span>Origin</a>
     <ol>
      <li><a href=#relaxing-the-same-origin-restriction><span class=secno>5.3.1 </span>Relaxing the same-origin restriction</a></ol></li>
@@ -4478,8 +4479,9 @@
   collection</a>.<p>The <dfn id=dom-htmlcollection-item title=dom-HTMLCollection-item><code>item(<var title="">index</var>)</code></dfn> method must return the <var title="">index</var>th node in the collection. If there is no <var title="">index</var>th node in the collection, then the method must
   return null.<p>The <dfn id=dom-htmlcollection-nameditem title=dom-HTMLCollection-namedItem><code>namedItem(<var title="">key</var>)</code></dfn> method must return the first node
   in the collection that matches the following requirements:<ul><li>It is an <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>,
-   <code><a href=#the-area-element>area</a></code>, <code><a href=#the-form-element>form</a></code>, <code><a href=#the-img-element>img</a></code>, or
-   <code><a href=#the-object-element>object</a></code> element with a <code title="">name</code> attribute equal to <var title="">key</var>, or,</li>
+   <code><a href=#the-area-element>area</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>
+   element with a <code title="">name</code> attribute equal to <var title="">key</var>, or,</li>
 
    <li>It is an element with an ID <var title="">key</var>.</li>
 
@@ -4872,7 +4874,7 @@
   <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>[<a href=#dom-document-nameditem title=dom-document-namedItem>NameGetter</a>]
+  longer defined as inheriting from <code>Document</code>.<pre class=idl>[<a href=#dom-document-nameditem title=dom-document-namedItem>NameGetter</a>=OverrideBuiltins]<!-- XXX http://krijnhoetmer.nl/irc-logs/whatwg/20090113#l-300 -->
 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>;
@@ -5246,26 +5248,60 @@
   <code><a href=#the-img-element>img</a></code> elements in the <code>Document</code> that have
   both <code title=attr-name>name</code> content attributes and <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>,
+  retrieval</dfn> using a name <var title="">name</var>, then the user
+  agent must return the value obtained using the following steps:<ol><li>
+
+    <p>Let <var title="">elements</var> be 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>.
+
+    <p class=note>There will be at least one such element, by
+    definition.<!-- (If there wasn't, then this algorithm wouldn't
+    have been invoked by WebIDL.) --></p>
+
+   </li>
+
+   <li>
+
+    <p>If <var title="">elements</var> has only one element, and that
+    element is an <code><a href=#the-iframe-element>iframe</a></code> element, then return the
+    <code><a href=#window>Window</a></code> object of the <a href=#default-view>default view</a> of the
+    <a href=#nested-browsing-context>nested browsing context</a> represented by that
+    <code><a href=#the-iframe-element>iframe</a></code> element, and abort these steps.</p>
+
+   </li>
+
+   <li>
+
+    <p>Otherwise, if <var title="">elements</var> has only one
+    element, return that element and abort these steps.</p>
+
+   </li>
+
+   <li>
+
+    <p>Otherwise return 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 -->
+
+   </li>
+
+  <!--
+  Note that this named getter overrides built-in properties, as in:
+     http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0D%0A...%3Ciframe%20name%3Dbody%3E%3C%2Fiframe%3E%3Cscript%3Ew(document.body)%3C%2Fscript%3E
+  This is what the "OverrideBuiltins" bit means in the IDL.
+  -->
+
+  </ol><p><dfn id=dom-document-nameditem-filter title=dom-document-nameditem-filter>Named elements</dfn>
+  with the name <var title="">name</var>, for the purposes of the
+  above algorithm, 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
    <a href=#fallback-free>fallback-free</a> <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 <a href=#fallback-free>fallback-free</a>
-   <code><a href=#the-object-element>object</a></code> elements that have an <code title=attr-id><a href=#the-id-attribute>id</a></code> content attribute whose value is <var title="">name</var>.</li>
+   <code><a href=#the-object-element>object</a></code> elements that have an <code title=attr-id><a href=#the-id-attribute>id</a></code> content attribute whose value is <var title="">name</var>, or</li>
 
    <li><code><a href=#the-img-element>img</a></code> elements that have an <code title=attr-id><a href=#the-id-attribute>id</a></code> content attribute whose value is <var title="">name</var>, and that have a <code title=attr-name>name</code> content attribute present also.</li>
 
@@ -5447,8 +5483,8 @@
    <dd><code title=attr-tabindex><a href=#attr-tabindex>tabindex</a></code></dd>
    <dd><code title=attr-title><a href=#the-title-attribute>title</a></code></dd>
   </dl><p>In addition, the following <a href=#event-handler-content-attributes>event handler content
-  attributes</a> may be specified on any <span>HTML
-  element</span>:<dl class=element><dt>Event handler content attributes:</dt>
+  attributes</a> may be specified on any <a href=#html-elements title="HTML
+  elements">HTML element</a>:<dl class=element><dt>Event handler content attributes:</dt>
    <dd><code title=handler-onabort><a href=#handler-onabort>onabort</a></code></dd>
    <dd><code title=handler-onbeforeunload><a href=#handler-onbeforeunload>onbeforeunload</a></code></dd>
    <dd><code title=handler-onblur><a href=#handler-onblur>onblur</a></code></dd>
@@ -5485,8 +5521,8 @@
    <dd><code title=handler-onunload><a href=#handler-onunload>onunload</a></code></dd>
   </dl><p>Also, <a href=#custom-data-attribute title="custom data attribute">custom data
   attributes</a> (e.g. <code title="">data-foldername</code> or
-  <code title="">data-msgid</code>) can be specified on any <span>HTML
-  element</span>, to store custom data specific to the page.<p>In <a href=#html-documents>HTML documents</a>, elements in the <a href=#html-namespace-0>HTML
+  <code title="">data-msgid</code>) can be specified on any <a href=#html-elements title="HTML elements">HTML element</a>, to store custom data
+  specific to the page.<p>In <a href=#html-documents>HTML documents</a>, elements in the <a href=#html-namespace-0>HTML
   namespace</a> may have an <code title="">xmlns</code> attribute
   specified, if, and only if, it has the exact value
   "<code>http://www.w3.org/1999/xhtml</code>". This does not apply to
@@ -27026,7 +27062,7 @@
 
   </ol><h3 id=the-default-view><span class=secno>5.2 </span>The default view</h3><p>The <code>AbstractView</code> object of <a href=#default-view title="default
   view">default views</a> must also implement the
-  <code><a href=#window>Window</a></code> and <code>EventTarget</code> interfaces.<pre class=idl>[NoInterfaceObject, IndexGetter]
+  <code><a href=#window>Window</a></code> and <code>EventTarget</code> interfaces.<pre class=idl>[NoInterfaceObject, <a href=#dom-window-item title=dom-window-item>IndexGetter</a>, <a href=#dom-window-nameditem title=dom-window-namedItem>NameGetter</a>]
 interface <dfn id=window>Window</dfn> {
   // the current browsing context
   readonly attribute <a href=#window>Window</a> <a href=#dom-window title=dom-window>window</a>;
@@ -27139,7 +27175,7 @@
    <li>The <code title=dom-frames><a href=#dom-frames>frames</a></code> attribute
 
    <li>Any <span title="corresponding indexed property">corresponding
-   indexed properties</span>
+   indexed properties</span> (used for <a href=#dom-window-item title=dom-window-item>accessing nested browsing contexts</a>)
 
   </ul><p>User agents must not allow scripts to override the <code title=dom-location><a href=#dom-location>location</a></code> object's setter.<h4 id=apis-for-creating-and-navigating-browsing-contexts-by-name><span class=secno>5.2.2 </span>APIs for creating and navigating browsing contexts by name</h4><p>The <dfn id=dom-open title=dom-open><code>open()</code></dfn> method on
   <code><a href=#window>Window</a></code> objects provides a mechanism for <a href=#navigate title=navigate>navigating</a> an existing <a href=#browsing-context>browsing
@@ -27207,11 +27243,12 @@
   any instant are the numbers in the range 0 .. <var title="">n</var>, where <var title="">n</var> is the
   number of <a href=#child-browsing-context title="child browsing context">child browsing
   contexts</a> of the <a href=#active-document title="active document">active</a>
-  <code>Document</code>.<p>The value of a <span>corresponding indexed property</span> <var title="">index</var> whenever an indexed property on a
-  <code><a href=#window>Window</a></code> object is retrieved is the <var title="">index</var>th <a href=#child-browsing-context>child browsing context</a> of the
-  <a href=#active-document title="active document">active</a> <code>Document</code>,
-  sorted in document order of the elements nesting those browsing
-  contexts.<h4 id=garbage-collection-and-browsing-contexts><span class=secno>5.2.4 </span>Garbage collection and browsing contexts</h4><p>A <a href=#browsing-context>browsing context</a> has a strong reference to each of
+  <code>Document</code>.<p>The value of a <span>corresponding indexed property</span> <var title="">index</var> whenever <dfn id=dom-window-item title=dom-window-item>an
+  indexed property on a <code>Window</code> object is retrieved</dfn>
+  is the <var title="">index</var>th <a href=#child-browsing-context>child browsing
+  context</a> of the <a href=#active-document title="active document">active</a>
+  <code>Document</code>, sorted in document order of the elements
+  nesting those browsing contexts.<h4 id=garbage-collection-and-browsing-contexts><span class=secno>5.2.4 </span>Garbage collection and browsing contexts</h4><p>A <a href=#browsing-context>browsing context</a> has a strong reference to each of
   its <code>Document</code>s and <a href=#view title=view>views</a>, and
   the user agent itself has a strong reference to its <a href=#top-level-browsing-context title="top-level browsing context">top-level browsing
   contexts</a>.<p>When a <a href=#browsing-context>browsing context</a> is to <dfn id=discard-a-document>discard a
@@ -27232,7 +27269,67 @@
   containing one or more <a href=#top-level-browsing-context title="top-level browsing
   context">top-level browsing contexts</a>). Other <a href=#browsing-context title="browsing context">browsing contexts</a> must be discarded
   once their <code><a href=#window>Window</a></code> object is eligible for garbage
-  collection.<h3 id=origin><span class=secno>5.3 </span>Origin</h3><!-- Hallowed are the Ori --><p>The <dfn id=origin-0>origin</dfn> of a resource and the <dfn id=effective-script-origin>effective script
+  collection.<h4 id=named-access-on-the-window-object><span class=secno>5.2.5 </span>Named access on the <code><a href=#window>Window</a></code> object</h4><p>The <code><a href=#window>Window</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:<ul><li>The value of the <code title="">name</code> content attribute
+   for all <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</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
+   <a href=#active-document>active document</a> that have a <code title="">name</code>
+   content attribute, and,</li>
+
+   <li>The value of the <code title=attr-id><a href=#the-id-attribute>id</a></code> content
+   attribute of any <a href=#html-elements title="HTML elements">HTML element</a> in
+   the <a href=#active-document>active document</a> with an <code title=attr-id><a href=#the-id-attribute>id</a></code> content attribute.</li>
+
+  </ul><p>When <dfn id=dom-window-nameditem title=dom-window-namedItem>the <code>Window</code>
+  object is indexed for property retrieval</dfn> using a name <var title="">name</var>, then the user agent must return the value
+  obtained using the following steps:<ol><li>
+
+    <p>Let <var title="">elements</var> be the list of <a href=#dom-window-nameditem-filter title=dom-window-namedItem-filter>named elements</a> with the
+    name <var title="">name</var> in the <a href=#active-document>active document</a>.
+
+    <p class=note>There will be at least one such element, by
+    definition.<!-- (If there wasn't, then this algorithm wouldn't
+    have been invoked by WebIDL.) --></p>
+
+   </li>
+
+   <li>
+
+    <p>If <var title="">elements</var> contains an <code><a href=#the-iframe-element>iframe</a></code>
+    element, then return the <code><a href=#window>Window</a></code> object of the
+    <a href=#default-view>default view</a> of the <a href=#nested-browsing-context>nested browsing
+    context</a> represented by the first such <code><a href=#the-iframe-element>iframe</a></code>
+    element in <a href=#tree-order>tree order</a>, and abort these steps.</p>
+
+   </li>
+
+   <li>
+
+    <p>Otherwise, if <var title="">elements</var> has only one
+    element, return that element and abort these steps.</p>
+
+   </li>
+
+   <li>
+
+    <p>Otherwise return an <code><a href=#htmlcollection-0>HTMLCollection</a></code> rooted at the
+    <code>Document</code> node, whose filter matches only <a href=#dom-window-nameditem-filter title=dom-window-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 -->
+
+   </li>
+
+  </ol><p><dfn id=dom-window-nameditem-filter title=dom-window-nameditem-filter>Named elements</dfn>
+  with the name <var title="">name</var>, for the purposes of the
+  above algorithm, are those that are either:<ul><li><code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</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><a href=#html-elements>HTML elements</a> elements that have an <code title=attr-id><a href=#the-id-attribute>id</a></code> content attribute whose value is <var title="">name</var>.</li>
+
+  </ul><h3 id=origin><span class=secno>5.3 </span>Origin</h3><!-- Hallowed are the Ori --><p>The <dfn id=origin-0>origin</dfn> of a resource and the <dfn id=effective-script-origin>effective script
   origin</dfn> of a resource are both either opaque identifiers or
   tuples consisting of a scheme component, a host component, a port
   component, and optionally extra data.<p class=note>The extra data could include the certificate of the
Received on Tuesday, 13 January 2009 07:46:54 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 13 January 2009 07:46:55 GMT