[html5] r4857 - [e] (0) Fix meaning of 'live' throughout. Hide a Window object that had leaked o [...]
whatwg at whatwg.org
whatwg at whatwg.org
Wed Mar 17 16:50:33 PDT 2010
Author: ianh
Date: 2010-03-17 16:50:31 -0700 (Wed, 17 Mar 2010)
New Revision: 4857
Modified:
complete.html
index
source
Log:
[e] (0) Fix meaning of 'live' throughout. Hide a Window object that had leaked out instead of turning into a WindowProxy object. Fix a note that had rotted.
Modified: complete.html
===================================================================
--- complete.html 2010-03-17 23:23:57 UTC (rev 4856)
+++ complete.html 2010-03-17 23:50:31 UTC (rev 4857)
@@ -2107,11 +2107,10 @@
be <dfn title="">setting</dfn> when a new value is assigned to
it.</p>
- <p>If a DOM object is said to be <dfn id=live>live</dfn>, then that means
- that any attributes returning that object <span class=impl>must</span> always return the same object (not a new
- object each time), and the attributes and methods on that object
- <span class=impl>must</span> operate on the actual underlying
- data, not a snapshot of the data.</p>
+ <p>If a DOM object is said to be <dfn id=live>live</dfn>, then the
+ attributes and methods on that object <span class=impl>must</span>
+ operate on the actual underlying data, not a snapshot of the
+ data.</p>
<p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used interchangeably in the context of
events, as in the DOM Events specifications. The term <dfn id=concept-events-trusted title=concept-events-trusted>trusted event</dfn> is used as
@@ -5974,8 +5973,8 @@
<li>Otherwise, if there are no nodes in the collection that have
either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attribute equal to <var title="">name</var>, then return null and stop the algorithm.</li>
- <li>Otherwise, create a <code><a href=#radionodelist>RadioNodeList</a></code> object
- representing a live view of the
+ <li>Otherwise, create a new <code><a href=#radionodelist>RadioNodeList</a></code> object
+ representing a <a href=#live>live</a> view of the
<code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> object, further filtered so
that the only nodes in the <code><a href=#radionodelist>RadioNodeList</a></code> object are
those that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute
@@ -6129,14 +6128,12 @@
either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-option-name>name</code> attribute equal to <var title="">name</var>, then return null and stop the algorithm.</li>
<!-- IE returns an HTMLCollection instead; we may need to change to that for compat -->
- <li>Otherwise, create a <code><a href=#nodelist>NodeList</a></code> object representing a
- live view of the <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> object, further
- filtered so that the only nodes in the <code><a href=#nodelist>NodeList</a></code> object
- are those that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code>
- attribute or a <code title=attr-option-name>name</code> attribute
- equal to <var title="">name</var>. The nodes in the
- <code><a href=#nodelist>NodeList</a></code> object must be sorted in <a href=#tree-order>tree
- order</a>.</li>
+ <li>Otherwise, create a new <code><a href=#nodelist>NodeList</a></code> object
+ representing a <a href=#live>live</a> view of the
+ <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> object, further filtered so that
+ the only nodes in the <code><a href=#nodelist>NodeList</a></code> object are those that
+ have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-option-name>name</code> attribute equal to <var title="">name</var>. The nodes in the <code><a href=#nodelist>NodeList</a></code> object
+ must be sorted in <a href=#tree-order>tree order</a>.</li>
<li>Return that <code><a href=#nodelist>NodeList</a></code> object.</li>
@@ -6249,22 +6246,20 @@
<a href=#represented-by-the-collection>represented by the collection</a>.</p>
<p>The <dfn id=dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names><code>names</code></dfn>
- attribute must return a live <code>DOMStringList</code> object
- giving the <a href=#property-names>property names</a> of all the elements
+ attribute must return a <a href=#live>live</a> <code>DOMStringList</code>
+ object giving the <a href=#property-names>property names</a> of all the elements
<a href=#represented-by-the-collection>represented by the collection</a>, listed in <a href=#tree-order>tree
order</a>, but with duplicates removed, leaving only the first
occurrence of each name. The same object must be returned each
time.</p>
<p>The <dfn id=dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
- <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a live view of the
- <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> object, further filtered so that
- the only nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those
- that have a <a href=#property-names title="property names">property name</a> equal
- to <var title="">name</var>. The nodes in the
- <code><a href=#propertynodelist>PropertyNodeList</a></code> object must be sorted in <a href=#tree-order>tree
- order</a>, and the same object must be returned each time a
- particular <var title="">name</var> is queried.</p>
+ <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a
+ <a href=#live>live</a> view of the <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code>
+ object, further filtered so that the only nodes in the
+ <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those that have a <a href=#property-names title="property names">property name</a> equal to <var title="">name</var>. The nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code>
+ object must be sorted in <a href=#tree-order>tree order</a>, and the same
+ object must be returned each time a particular <var title="">name</var> is queried.</p>
<hr><p>Members of the <code><a href=#propertynodelist>PropertyNodeList</a></code> interface inherited
from the <code><a href=#nodelist>NodeList</a></code> interface must behave as they would
@@ -7476,19 +7471,19 @@
</dl><div class=impl>
- <p>The <dfn id=dom-document-getelementsbyname title=dom-document-getElementsByName><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a live <code><a href=#nodelist>NodeList</a></code>
- containing all the <a href=#html-elements>HTML elements</a> in that document that
- have a <code title="">name</code> attribute whose value is equal to
- the <var title="">name</var> argument (in a
- <a href=#case-sensitive>case-sensitive</a> manner), in <a href=#tree-order>tree order</a>. A
- new <code><a href=#nodelist>NodeList</a></code> object must be returned each time unless
- the argument is the same as the last time the method was invoked on
- this <code><a href=#document>Document</a></code> object, in which case the object must be
- the same as the object returned by the previous call.</p>
+ <p>The <dfn id=dom-document-getelementsbyname title=dom-document-getElementsByName><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a <a href=#live>live</a>
+ <code><a href=#nodelist>NodeList</a></code> containing all the <a href=#html-elements>HTML elements</a>
+ in that document that have a <code title="">name</code> attribute
+ whose value is equal to the <var title="">name</var> argument (in a
+ <a href=#case-sensitive>case-sensitive</a> manner), in <a href=#tree-order>tree order</a>.
+ When the method is invoked on a <code><a href=#document>Document</a></code> object again
+ with the same argument, the user agent may return the same as the
+ object returned by the earlier call. In other cases, a new
+ <code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
<p>The <dfn id=dom-document-getelementsbyclassname title=dom-document-getElementsByClassName><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method takes a string that
contains a <a href=#set-of-space-separated-tokens>set of space-separated tokens</a> representing
- classes. When called, the method must return a live
+ classes. When called, the method must return a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> object containing all the elements in the
document, in <a href=#tree-order>tree order</a>, that have all the classes
specified in that argument, having obtained the classes by <a href=#split-a-string-on-spaces title="split a string on spaces">splitting a string on
@@ -7504,7 +7499,7 @@
<code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
<p>The <dfn id=dom-getelementsbyclassname title=dom-getElementsByClassName><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method on the
- <code><a href=#htmlelement>HTMLElement</a></code> interface must return a live
+ <code><a href=#htmlelement>HTMLElement</a></code> interface must return a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> with the nodes that the
<code><a href=#htmldocument>HTMLDocument</a></code> <code title=dom-document-getElementsByClassName><a href=#dom-document-getelementsbyclassname>getElementsByClassName()</a></code>
method would return when passed the same argument(s), excluding any
@@ -25603,9 +25598,9 @@
value.</p>
<p>When set to a <code><a href=#canvaspattern>CanvasPattern</a></code> or
- <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is live, meaning
- that changes made to the object after the assignment do affect
- subsequent stroking or filling of shapes.</p>
+ <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is
+ <a href=#live>live</a>, meaning that changes made to the object after the
+ assignment do affect subsequent stroking or filling of shapes.</p>
<p>On getting, if the value is a color, then the <a href=#serialization-of-a-color title="serialization of a color">serialization of the color</a>
must be returned. Otherwise, if it is not a color but a
@@ -28501,7 +28496,7 @@
for an <code><a href=#the-area-element>area</a></code> element to correspond to multiple focusable
areas of the document.</p>
- <p>Image maps are <em>live</em>; if the DOM is mutated, then the
+ <p>Image maps are <a href=#live>live</a>; if the DOM is mutated, then the
user agent must act as if it had rerun the algorithms for image
maps.</p>
@@ -40446,9 +40441,8 @@
<p>The <dfn id=dom-cva-validity title=dom-cva-validity><code>validity</code></dfn>
attribute must return a <code><a href=#validitystate>ValidityState</a></code> object that
represents the <a href=#validity-states>validity states</a> of the element. This
- object is live, and the same object must be returned each time the
- element's <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code> attribute
- is retrieved.</p>
+ object is <a href=#live>live</a>, and the same object must be returned
+ each time the element's <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code> attribute is retrieved.</p>
<pre class=idl>interface <dfn id=validitystate>ValidityState</dfn> {
readonly attribute boolean <a href=#dom-validitystate-valuemissing title=dom-ValidityState-valueMissing>valueMissing</a>;
@@ -44849,8 +44843,8 @@
attribute must return a list containing the elements that can
trigger the command (the command's <span
title="command-facet-Triggers">Triggers</span>). The list must be
- <span>live</span>. While the element does not define a command, the
- list must be empty.</p>
+ <span>live</span>. The same object must be returned each time. While
+ the element does not define a command, the list must be empty.</p>
-->
<p class=note>The <a href=#command-facet-id title=command-facet-ID>ID</a> facet
@@ -48396,15 +48390,15 @@
<p>The <dfn id=dom-document-getitems title=dom-document-getItems><code>document.getItems(<var title="">typeNames</var>)</code></dfn> method takes an optional
string that contains an <a href=#unordered-set-of-unique-space-separated-tokens>unordered set of unique
space-separated tokens</a> representing types. When called, the
- method must return a live <code><a href=#nodelist>NodeList</a></code> object containing
- all the elements in the document, in <a href=#tree-order>tree order</a>, that
- are each <a href=#top-level-microdata-items>top-level microdata items</a> with a <a href=#item-type title="item type">type</a> equal to one of the types specified in
- that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a
- string on spaces">splitting the string on spaces</a>. If there
- are no tokens specified in the argument, or if the argument is
- missing, then the method must return a <code><a href=#nodelist>NodeList</a></code>
- containing all the <a href=#top-level-microdata-items>top-level microdata items</a> in the
- document.
+ method must return a <a href=#live>live</a> <code><a href=#nodelist>NodeList</a></code> object
+ containing all the elements in the document, in <a href=#tree-order>tree
+ order</a>, that are each <a href=#top-level-microdata-items>top-level microdata items</a>
+ with a <a href=#item-type title="item type">type</a> equal to one of the types
+ specified in that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a string on spaces">splitting the string on
+ spaces</a>. If there are no tokens specified in the argument, or
+ if the argument is missing, then the method must return a
+ <code><a href=#nodelist>NodeList</a></code> containing all the <a href=#top-level-microdata-items>top-level microdata
+ items</a> in the document.
When the method is invoked on a <code><a href=#document>Document</a></code> object again
with the same argument, the user agent may return the same object as
the object returned by the earlier call. In other cases, a new
@@ -62436,8 +62430,8 @@
the last of those values that it was set to.</p>
<p>The <dfn id=dom-datatransfer-types title=dom-DataTransfer-types><code>types</code></dfn>
- attribute must return a live <code>DOMStringList</code> that
- contains the list of formats that were added to the
+ attribute must return a <a href=#live>live</a> <code>DOMStringList</code>
+ that contains the list of formats that were added to the
<code><a href=#datatransfer>DataTransfer</a></code> object in the corresponding <code title=event-dragstart><a href=#event-dragstart>dragstart</a></code> event. The same object must
be returned each time. If any files were included in the drag, then
the <code>DOMStringList</code> object must in addition include the
@@ -70303,9 +70297,9 @@
set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
- set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
- invariant: the global object is always a Window if the script can
- see this method -->
+ set to the <a href="#script's-global-object">script's global object</a>'s
+ <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+ object is always a Window if the script can see this method -->
</li>
@@ -70419,9 +70413,9 @@
set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
- set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
- invariant: the global object is always a Window if the script can
- see this method -->
+ set to the <a href="#script's-global-object">script's global object</a>'s
+ <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+ object is always a Window if the script can see this method -->
</li>
@@ -70441,9 +70435,9 @@
</li>
- </ol><p class=note>These steps, with the exception of the second and
- third steps and the penultimate step, are identical to those in the
- previous section.</p>
+ </ol><p class=note>These steps, with the exception of the third,
+ fourth, and fifth steps and the penultimate step, are identical to
+ those in the previous section.</p>
<!-- v2: we can merge this section and the previous section when
implementations have shipped postMessage(). Anne asked that these
Modified: index
===================================================================
--- index 2010-03-17 23:23:57 UTC (rev 4856)
+++ index 2010-03-17 23:50:31 UTC (rev 4857)
@@ -2006,11 +2006,10 @@
be <dfn title="">setting</dfn> when a new value is assigned to
it.</p>
- <p>If a DOM object is said to be <dfn id=live>live</dfn>, then that means
- that any attributes returning that object <span class=impl>must</span> always return the same object (not a new
- object each time), and the attributes and methods on that object
- <span class=impl>must</span> operate on the actual underlying
- data, not a snapshot of the data.</p>
+ <p>If a DOM object is said to be <dfn id=live>live</dfn>, then the
+ attributes and methods on that object <span class=impl>must</span>
+ operate on the actual underlying data, not a snapshot of the
+ data.</p>
<p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used interchangeably in the context of
events, as in the DOM Events specifications. The term <dfn id=concept-events-trusted title=concept-events-trusted>trusted event</dfn> is used as
@@ -5873,8 +5872,8 @@
<li>Otherwise, if there are no nodes in the collection that have
either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attribute equal to <var title="">name</var>, then return null and stop the algorithm.</li>
- <li>Otherwise, create a <code><a href=#radionodelist>RadioNodeList</a></code> object
- representing a live view of the
+ <li>Otherwise, create a new <code><a href=#radionodelist>RadioNodeList</a></code> object
+ representing a <a href=#live>live</a> view of the
<code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> object, further filtered so
that the only nodes in the <code><a href=#radionodelist>RadioNodeList</a></code> object are
those that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute
@@ -6028,14 +6027,12 @@
either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-option-name>name</code> attribute equal to <var title="">name</var>, then return null and stop the algorithm.</li>
<!-- IE returns an HTMLCollection instead; we may need to change to that for compat -->
- <li>Otherwise, create a <code><a href=#nodelist>NodeList</a></code> object representing a
- live view of the <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> object, further
- filtered so that the only nodes in the <code><a href=#nodelist>NodeList</a></code> object
- are those that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code>
- attribute or a <code title=attr-option-name>name</code> attribute
- equal to <var title="">name</var>. The nodes in the
- <code><a href=#nodelist>NodeList</a></code> object must be sorted in <a href=#tree-order>tree
- order</a>.</li>
+ <li>Otherwise, create a new <code><a href=#nodelist>NodeList</a></code> object
+ representing a <a href=#live>live</a> view of the
+ <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> object, further filtered so that
+ the only nodes in the <code><a href=#nodelist>NodeList</a></code> object are those that
+ have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-option-name>name</code> attribute equal to <var title="">name</var>. The nodes in the <code><a href=#nodelist>NodeList</a></code> object
+ must be sorted in <a href=#tree-order>tree order</a>.</li>
<li>Return that <code><a href=#nodelist>NodeList</a></code> object.</li>
@@ -6148,22 +6145,20 @@
<a href=#represented-by-the-collection>represented by the collection</a>.</p>
<p>The <dfn id=dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names><code>names</code></dfn>
- attribute must return a live <code>DOMStringList</code> object
- giving the <a href=#property-names>property names</a> of all the elements
+ attribute must return a <a href=#live>live</a> <code>DOMStringList</code>
+ object giving the <a href=#property-names>property names</a> of all the elements
<a href=#represented-by-the-collection>represented by the collection</a>, listed in <a href=#tree-order>tree
order</a>, but with duplicates removed, leaving only the first
occurrence of each name. The same object must be returned each
time.</p>
<p>The <dfn id=dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
- <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a live view of the
- <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> object, further filtered so that
- the only nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those
- that have a <a href=#property-names title="property names">property name</a> equal
- to <var title="">name</var>. The nodes in the
- <code><a href=#propertynodelist>PropertyNodeList</a></code> object must be sorted in <a href=#tree-order>tree
- order</a>, and the same object must be returned each time a
- particular <var title="">name</var> is queried.</p>
+ <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a
+ <a href=#live>live</a> view of the <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code>
+ object, further filtered so that the only nodes in the
+ <code><a href=#propertynodelist>PropertyNodeList</a></code> object are those that have a <a href=#property-names title="property names">property name</a> equal to <var title="">name</var>. The nodes in the <code><a href=#propertynodelist>PropertyNodeList</a></code>
+ object must be sorted in <a href=#tree-order>tree order</a>, and the same
+ object must be returned each time a particular <var title="">name</var> is queried.</p>
<hr><p>Members of the <code><a href=#propertynodelist>PropertyNodeList</a></code> interface inherited
from the <code><a href=#nodelist>NodeList</a></code> interface must behave as they would
@@ -7375,19 +7370,19 @@
</dl><div class=impl>
- <p>The <dfn id=dom-document-getelementsbyname title=dom-document-getElementsByName><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a live <code><a href=#nodelist>NodeList</a></code>
- containing all the <a href=#html-elements>HTML elements</a> in that document that
- have a <code title="">name</code> attribute whose value is equal to
- the <var title="">name</var> argument (in a
- <a href=#case-sensitive>case-sensitive</a> manner), in <a href=#tree-order>tree order</a>. A
- new <code><a href=#nodelist>NodeList</a></code> object must be returned each time unless
- the argument is the same as the last time the method was invoked on
- this <code><a href=#document>Document</a></code> object, in which case the object must be
- the same as the object returned by the previous call.</p>
+ <p>The <dfn id=dom-document-getelementsbyname title=dom-document-getElementsByName><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a <a href=#live>live</a>
+ <code><a href=#nodelist>NodeList</a></code> containing all the <a href=#html-elements>HTML elements</a>
+ in that document that have a <code title="">name</code> attribute
+ whose value is equal to the <var title="">name</var> argument (in a
+ <a href=#case-sensitive>case-sensitive</a> manner), in <a href=#tree-order>tree order</a>.
+ When the method is invoked on a <code><a href=#document>Document</a></code> object again
+ with the same argument, the user agent may return the same as the
+ object returned by the earlier call. In other cases, a new
+ <code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
<p>The <dfn id=dom-document-getelementsbyclassname title=dom-document-getElementsByClassName><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method takes a string that
contains a <a href=#set-of-space-separated-tokens>set of space-separated tokens</a> representing
- classes. When called, the method must return a live
+ classes. When called, the method must return a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> object containing all the elements in the
document, in <a href=#tree-order>tree order</a>, that have all the classes
specified in that argument, having obtained the classes by <a href=#split-a-string-on-spaces title="split a string on spaces">splitting a string on
@@ -7403,7 +7398,7 @@
<code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
<p>The <dfn id=dom-getelementsbyclassname title=dom-getElementsByClassName><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method on the
- <code><a href=#htmlelement>HTMLElement</a></code> interface must return a live
+ <code><a href=#htmlelement>HTMLElement</a></code> interface must return a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> with the nodes that the
<code><a href=#htmldocument>HTMLDocument</a></code> <code title=dom-document-getElementsByClassName><a href=#dom-document-getelementsbyclassname>getElementsByClassName()</a></code>
method would return when passed the same argument(s), excluding any
@@ -25505,9 +25500,9 @@
value.</p>
<p>When set to a <code><a href=#canvaspattern>CanvasPattern</a></code> or
- <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is live, meaning
- that changes made to the object after the assignment do affect
- subsequent stroking or filling of shapes.</p>
+ <code><a href=#canvasgradient>CanvasGradient</a></code> object, the assignment is
+ <a href=#live>live</a>, meaning that changes made to the object after the
+ assignment do affect subsequent stroking or filling of shapes.</p>
<p>On getting, if the value is a color, then the <a href=#serialization-of-a-color title="serialization of a color">serialization of the color</a>
must be returned. Otherwise, if it is not a color but a
@@ -28403,7 +28398,7 @@
for an <code><a href=#the-area-element>area</a></code> element to correspond to multiple focusable
areas of the document.</p>
- <p>Image maps are <em>live</em>; if the DOM is mutated, then the
+ <p>Image maps are <a href=#live>live</a>; if the DOM is mutated, then the
user agent must act as if it had rerun the algorithms for image
maps.</p>
@@ -40348,9 +40343,8 @@
<p>The <dfn id=dom-cva-validity title=dom-cva-validity><code>validity</code></dfn>
attribute must return a <code><a href=#validitystate>ValidityState</a></code> object that
represents the <a href=#validity-states>validity states</a> of the element. This
- object is live, and the same object must be returned each time the
- element's <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code> attribute
- is retrieved.</p>
+ object is <a href=#live>live</a>, and the same object must be returned
+ each time the element's <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code> attribute is retrieved.</p>
<pre class=idl>interface <dfn id=validitystate>ValidityState</dfn> {
readonly attribute boolean <a href=#dom-validitystate-valuemissing title=dom-ValidityState-valueMissing>valueMissing</a>;
@@ -44751,8 +44745,8 @@
attribute must return a list containing the elements that can
trigger the command (the command's <span
title="command-facet-Triggers">Triggers</span>). The list must be
- <span>live</span>. While the element does not define a command, the
- list must be empty.</p>
+ <span>live</span>. The same object must be returned each time. While
+ the element does not define a command, the list must be empty.</p>
-->
<p class=note>The <a href=#command-facet-id title=command-facet-ID>ID</a> facet
@@ -48298,15 +48292,15 @@
<p>The <dfn id=dom-document-getitems title=dom-document-getItems><code>document.getItems(<var title="">typeNames</var>)</code></dfn> method takes an optional
string that contains an <a href=#unordered-set-of-unique-space-separated-tokens>unordered set of unique
space-separated tokens</a> representing types. When called, the
- method must return a live <code><a href=#nodelist>NodeList</a></code> object containing
- all the elements in the document, in <a href=#tree-order>tree order</a>, that
- are each <a href=#top-level-microdata-items>top-level microdata items</a> with a <a href=#item-type title="item type">type</a> equal to one of the types specified in
- that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a
- string on spaces">splitting the string on spaces</a>. If there
- are no tokens specified in the argument, or if the argument is
- missing, then the method must return a <code><a href=#nodelist>NodeList</a></code>
- containing all the <a href=#top-level-microdata-items>top-level microdata items</a> in the
- document.
+ method must return a <a href=#live>live</a> <code><a href=#nodelist>NodeList</a></code> object
+ containing all the elements in the document, in <a href=#tree-order>tree
+ order</a>, that are each <a href=#top-level-microdata-items>top-level microdata items</a>
+ with a <a href=#item-type title="item type">type</a> equal to one of the types
+ specified in that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a string on spaces">splitting the string on
+ spaces</a>. If there are no tokens specified in the argument, or
+ if the argument is missing, then the method must return a
+ <code><a href=#nodelist>NodeList</a></code> containing all the <a href=#top-level-microdata-items>top-level microdata
+ items</a> in the document.
When the method is invoked on a <code><a href=#document>Document</a></code> object again
with the same argument, the user agent may return the same object as
the object returned by the earlier call. In other cases, a new
@@ -62364,8 +62358,8 @@
the last of those values that it was set to.</p>
<p>The <dfn id=dom-datatransfer-types title=dom-DataTransfer-types><code>types</code></dfn>
- attribute must return a live <code>DOMStringList</code> that
- contains the list of formats that were added to the
+ attribute must return a <a href=#live>live</a> <code>DOMStringList</code>
+ that contains the list of formats that were added to the
<code><a href=#datatransfer>DataTransfer</a></code> object in the corresponding <code title=event-dragstart><a href=#event-dragstart>dragstart</a></code> event. The same object must
be returned each time. If any files were included in the drag, then
the <code>DOMStringList</code> object must in addition include the
@@ -64410,9 +64404,9 @@
set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
- set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
- invariant: the global object is always a Window if the script can
- see this method -->
+ set to the <a href="#script's-global-object">script's global object</a>'s
+ <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+ object is always a Window if the script can see this method -->
</li>
@@ -64526,9 +64520,9 @@
set to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
the script that invoked the method, and the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
- set to the <a href="#script's-global-object">script's global object</a>.</p> <!--
- invariant: the global object is always a Window if the script can
- see this method -->
+ set to the <a href="#script's-global-object">script's global object</a>'s
+ <code><a href=#windowproxy>WindowProxy</a></code> object.</p> <!-- invariant: the global
+ object is always a Window if the script can see this method -->
</li>
@@ -64548,9 +64542,9 @@
</li>
- </ol><p class=note>These steps, with the exception of the second and
- third steps and the penultimate step, are identical to those in the
- previous section.</p>
+ </ol><p class=note>These steps, with the exception of the third,
+ fourth, and fifth steps and the penultimate step, are identical to
+ those in the previous section.</p>
<!-- v2: we can merge this section and the previous section when
implementations have shipped postMessage(). Anne asked that these
Modified: source
===================================================================
--- source 2010-03-17 23:23:57 UTC (rev 4856)
+++ source 2010-03-17 23:50:31 UTC (rev 4857)
@@ -979,12 +979,10 @@
be <dfn title="">setting</dfn> when a new value is assigned to
it.</p>
- <p>If a DOM object is said to be <dfn>live</dfn>, then that means
- that any attributes returning that object <span
- class="impl">must</span> always return the same object (not a new
- object each time), and the attributes and methods on that object
- <span class="impl">must</span> operate on the actual underlying
- data, not a snapshot of the data.</p>
+ <p>If a DOM object is said to be <dfn>live</dfn>, then the
+ attributes and methods on that object <span class="impl">must</span>
+ operate on the actual underlying data, not a snapshot of the
+ data.</p>
<p>The terms <dfn title="">fire</dfn> and <dfn
title="">dispatch</dfn> are used interchangeably in the context of
@@ -5584,8 +5582,8 @@
title="attr-fe-name">name</code> attribute equal to <var
title="">name</var>, then return null and stop the algorithm.</li>
- <li>Otherwise, create a <code>RadioNodeList</code> object
- representing a live view of the
+ <li>Otherwise, create a new <code>RadioNodeList</code> object
+ representing a <span>live</span> view of the
<code>HTMLFormControlsCollection</code> object, further filtered so
that the only nodes in the <code>RadioNodeList</code> object are
those that have either an <code title="attr-id">id</code> attribute
@@ -5773,14 +5771,14 @@
title="">name</var>, then return null and stop the algorithm.</li>
<!-- IE returns an HTMLCollection instead; we may need to change to that for compat -->
- <li>Otherwise, create a <code>NodeList</code> object representing a
- live view of the <code>HTMLOptionsCollection</code> object, further
- filtered so that the only nodes in the <code>NodeList</code> object
- are those that have either an <code title="attr-id">id</code>
- attribute or a <code title="attr-option-name">name</code> attribute
- equal to <var title="">name</var>. The nodes in the
- <code>NodeList</code> object must be sorted in <span>tree
- order</span>.</li>
+ <li>Otherwise, create a new <code>NodeList</code> object
+ representing a <span>live</span> view of the
+ <code>HTMLOptionsCollection</code> object, further filtered so that
+ the only nodes in the <code>NodeList</code> object are those that
+ have either an <code title="attr-id">id</code> attribute or a <code
+ title="attr-option-name">name</code> attribute equal to <var
+ title="">name</var>. The nodes in the <code>NodeList</code> object
+ must be sorted in <span>tree order</span>.</li>
<li>Return that <code>NodeList</code> object.</li>
@@ -5926,8 +5924,8 @@
<p>The <dfn
title="dom-HTMLPropertiesCollection-names"><code>names</code></dfn>
- attribute must return a live <code>DOMStringList</code> object
- giving the <span>property names</span> of all the elements
+ attribute must return a <span>live</span> <code>DOMStringList</code>
+ object giving the <span>property names</span> of all the elements
<span>represented by the collection</span>, listed in <span>tree
order</span>, but with duplicates removed, leaving only the first
occurrence of each name. The same object must be returned each
@@ -5936,14 +5934,15 @@
<p>The <dfn
title="dom-HTMLPropertiesCollection-namedItem"><code>namedItem(<var
title="">name</var>)</code></dfn> method must return a
- <code>PropertyNodeList</code> object representing a live view of the
- <code>HTMLPropertiesCollection</code> object, further filtered so that
- the only nodes in the <code>PropertyNodeList</code> object are those
- that have a <span title="property names">property name</span> equal
- to <var title="">name</var>. The nodes in the
- <code>PropertyNodeList</code> object must be sorted in <span>tree
- order</span>, and the same object must be returned each time a
- particular <var title="">name</var> is queried.</p>
+ <code>PropertyNodeList</code> object representing a
+ <span>live</span> view of the <code>HTMLPropertiesCollection</code>
+ object, further filtered so that the only nodes in the
+ <code>PropertyNodeList</code> object are those that have a <span
+ title="property names">property name</span> equal to <var
+ title="">name</var>. The nodes in the <code>PropertyNodeList</code>
+ object must be sorted in <span>tree order</span>, and the same
+ object must be returned each time a particular <var
+ title="">name</var> is queried.</p>
<hr>
@@ -7362,21 +7361,21 @@
<p>The <dfn
title="dom-document-getElementsByName"><code>getElementsByName(<var
title="">name</var>)</code></dfn> method takes a string <var
- title="">name</var>, and must return a live <code>NodeList</code>
- containing all the <span>HTML elements</span> in that document that
- have a <code title="">name</code> attribute whose value is equal to
- the <var title="">name</var> argument (in a
- <span>case-sensitive</span> manner), in <span>tree order</span>. A
- new <code>NodeList</code> object must be returned each time unless
- the argument is the same as the last time the method was invoked on
- this <code>Document</code> object, in which case the object must be
- the same as the object returned by the previous call.</p>
+ title="">name</var>, and must return a <span>live</span>
+ <code>NodeList</code> containing all the <span>HTML elements</span>
+ in that document that have a <code title="">name</code> attribute
+ whose value is equal to the <var title="">name</var> argument (in a
+ <span>case-sensitive</span> manner), in <span>tree order</span>.
+ When the method is invoked on a <code>Document</code> object again
+ with the same argument, the user agent may return the same as the
+ object returned by the earlier call. In other cases, a new
+ <code>NodeList</code> object must be returned.</p>
<p>The <dfn
title="dom-document-getElementsByClassName"><code>getElementsByClassName(<var
title="">classNames</var>)</code></dfn> method takes a string that
contains a <span>set of space-separated tokens</span> representing
- classes. When called, the method must return a live
+ classes. When called, the method must return a <span>live</span>
<code>NodeList</code> object containing all the elements in the
document, in <span>tree order</span>, that have all the classes
specified in that argument, having obtained the classes by <span
@@ -7395,7 +7394,7 @@
<p>The <dfn
title="dom-getElementsByClassName"><code>getElementsByClassName(<var
title="">classNames</var>)</code></dfn> method on the
- <code>HTMLElement</code> interface must return a live
+ <code>HTMLElement</code> interface must return a <span>live</span>
<code>NodeList</code> with the nodes that the
<code>HTMLDocument</code> <code
title="dom-document-getElementsByClassName">getElementsByClassName()</code>
@@ -27744,9 +27743,9 @@
value.</p>
<p>When set to a <code>CanvasPattern</code> or
- <code>CanvasGradient</code> object, the assignment is live, meaning
- that changes made to the object after the assignment do affect
- subsequent stroking or filling of shapes.</p>
+ <code>CanvasGradient</code> object, the assignment is
+ <span>live</span>, meaning that changes made to the object after the
+ assignment do affect subsequent stroking or filling of shapes.</p>
<p>On getting, if the value is a color, then the <span
title="serialization of a color">serialization of the color</span>
@@ -31252,7 +31251,7 @@
for an <code>area</code> element to correspond to multiple focusable
areas of the document.</p>
- <p>Image maps are <em>live</em>; if the DOM is mutated, then the
+ <p>Image maps are <span>live</span>; if the DOM is mutated, then the
user agent must act as if it had rerun the algorithms for image
maps.</p>
@@ -45120,9 +45119,9 @@
<p>The <dfn title="dom-cva-validity"><code>validity</code></dfn>
attribute must return a <code>ValidityState</code> object that
represents the <span>validity states</span> of the element. This
- object is live, and the same object must be returned each time the
- element's <code title="dom-cva-validity">validity</code> attribute
- is retrieved.</p>
+ object is <span>live</span>, and the same object must be returned
+ each time the element's <code
+ title="dom-cva-validity">validity</code> attribute is retrieved.</p>
<pre class="idl">interface <dfn>ValidityState</dfn> {
readonly attribute boolean <span title="dom-ValidityState-valueMissing">valueMissing</span>;
@@ -49845,8 +49844,8 @@
attribute must return a list containing the elements that can
trigger the command (the command's <span
title="command-facet-Triggers">Triggers</span>). The list must be
- <span>live</span>. While the element does not define a command, the
- list must be empty.</p>
+ <span>live</span>. The same object must be returned each time. While
+ the element does not define a command, the list must be empty.</p>
-->
<p class="note">The <span title="command-facet-ID">ID</span> facet
@@ -53982,16 +53981,16 @@
title="">typeNames</var>)</code></dfn> method takes an optional
string that contains an <span>unordered set of unique
space-separated tokens</span> representing types. When called, the
- method must return a live <code>NodeList</code> object containing
- all the elements in the document, in <span>tree order</span>, that
- are each <span>top-level microdata items</span> with a <span
- title="item type">type</span> equal to one of the types specified in
- that argument, having obtained the types by <span title="split a
- string on spaces">splitting the string on spaces</span>. If there
- are no tokens specified in the argument, or if the argument is
- missing, then the method must return a <code>NodeList</code>
- containing all the <span>top-level microdata items</span> in the
- document.
+ method must return a <span>live</span> <code>NodeList</code> object
+ containing all the elements in the document, in <span>tree
+ order</span>, that are each <span>top-level microdata items</span>
+ with a <span title="item type">type</span> equal to one of the types
+ specified in that argument, having obtained the types by <span
+ title="split a string on spaces">splitting the string on
+ spaces</span>. If there are no tokens specified in the argument, or
+ if the argument is missing, then the method must return a
+ <code>NodeList</code> containing all the <span>top-level microdata
+ items</span> in the document.
When the method is invoked on a <code>Document</code> object again
with the same argument, the user agent may return the same object as
the object returned by the earlier call. In other cases, a new
@@ -70617,8 +70616,8 @@
the last of those values that it was set to.</p>
<p>The <dfn title="dom-DataTransfer-types"><code>types</code></dfn>
- attribute must return a live <code>DOMStringList</code> that
- contains the list of formats that were added to the
+ attribute must return a <span>live</span> <code>DOMStringList</code>
+ that contains the list of formats that were added to the
<code>DataTransfer</code> object in the corresponding <code
title="event-dragstart">dragstart</code> event. The same object must
be returned each time. If any files were included in the drag, then
@@ -79103,9 +79102,9 @@
origin">Unicode serialization</span> of the <span>origin</span> of
the script that invoked the method, and the <code
title="dom-MessageEvent-source">source</code> attribute must be
- set to the <span>script's global object</span>.</p> <!--
- invariant: the global object is always a Window if the script can
- see this method -->
+ set to the <span>script's global object</span>'s
+ <code>WindowProxy</code> object.</p> <!-- invariant: the global
+ object is always a Window if the script can see this method -->
</li>
@@ -79240,9 +79239,9 @@
origin">Unicode serialization</span> of the <span>origin</span> of
the script that invoked the method, and the <code
title="dom-MessageEvent-source">source</code> attribute must be
- set to the <span>script's global object</span>.</p> <!--
- invariant: the global object is always a Window if the script can
- see this method -->
+ set to the <span>script's global object</span>'s
+ <code>WindowProxy</code> object.</p> <!-- invariant: the global
+ object is always a Window if the script can see this method -->
</li>
@@ -79266,9 +79265,9 @@
</ol>
- <p class="note">These steps, with the exception of the second and
- third steps and the penultimate step, are identical to those in the
- previous section.</p>
+ <p class="note">These steps, with the exception of the third,
+ fourth, and fifth steps and the penultimate step, are identical to
+ those in the previous section.</p>
<!-- v2: we can merge this section and the previous section when
implementations have shipped postMessage(). Anne asked that these
More information about the Commit-Watchers
mailing list