[html5] r3290 - [] (0) Cleanup terminology related to 'in the document'; 'removed from the docum [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Jun 16 17:11:40 PDT 2009
Author: ianh
Date: 2009-06-16 17:11:38 -0700 (Tue, 16 Jun 2009)
New Revision: 3290
Modified:
index
source
Log:
[] (0) Cleanup terminology related to 'in the document'; 'removed from the document', etc.
Modified: index
===================================================================
--- index 2009-06-16 23:41:36 UTC (rev 3289)
+++ index 2009-06-17 00:11:38 UTC (rev 3290)
@@ -39,7 +39,7 @@
<div class=head>
<p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<h1>HTML 5</h1>
- <h2 class="no-num no-toc" id=draft-standard-—-date:-01-jan-1901>Draft Standard — 16 June 2009</h2>
+ <h2 class="no-num no-toc" id=draft-standard-—-date:-01-jan-1901>Draft Standard — 17 June 2009</h2>
<p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<dl><dt>Multiple-page version:</dt>
@@ -1559,10 +1559,17 @@
element) is the <code>Document</code> that the <code>Node</code>'s
<code title="">ownerDocument</code> DOM attribute returns.</p>
- <p>An element is said to have been <dfn id=insert-an-element-into-a-document title="insert an element
- into a document">inserted into a document</dfn> when its <a href=#root-element>root
- element</a> changes and is now the document's <a href=#root-element>root
- element</a>. If a <code>Node</code> is in a <code>Document</code>
+ <p>When an element's <a href=#root-element>root element</a> is the <a href=#root-element>root
+ element</a> of a <code>Document</code>, it is said to be <dfn id=in-a-document>in
+ a <code>Document</code></dfn>. An element is said to have been <dfn id=insert-an-element-into-a-document title="insert an element into a document">inserted into a
+ document</dfn> when its <a href=#root-element>root element</a> changes and is now
+ the document's <a href=#root-element>root element</a>. Analogously, an element is
+ said to have been <dfn id=remove-an-element-from-a-document title="remove an element from a
+ document">removed from a document</dfn> when its <a href=#root-element>root
+ element</a> changes from being the document's <a href=#root-element>root
+ element</a> to being another element.</p>
+
+ <p>If a <code>Node</code> is <a href=#in-a-document>in a <code>Document</code></a>
then that <code>Document</code> is always the <code>Node</code>'s
<code>Document</code>, and the <code>Node</code>'s <code title="">ownerDocument</code> DOM attribute thus always returns that
<code>Document</code>.</p>
@@ -21339,15 +21346,15 @@
<code title=event-pause><a href=#event-pause>pause</a></code> event doesn't fire).</p>
<p><a href=#media-element title="media element">Media elements</a> that are
- <a href=#potentially-playing>potentially playing</a> while not <span>in a
- <code>Document</code></span><!-- XXX xref --> must not play any
- video, but should play any audio component. Media elements must not
- stop playing just because all references to them have been removed;
- only once a media element to which no references exist has reached a
- point where no further audio remains to be played for that element
- (e.g. because the element is paused, or because the end of the clip
- has been reached, or because its <code title=dom-media-playbackRate><a href=#dom-media-playbackrate>playbackRate</a></code> is 0.0) may the
- element be <span>garbage collected</span><!-- XXX xref -->.</p>
+ <a href=#potentially-playing>potentially playing</a> while not <a href=#in-a-document>in a
+ <code>Document</code></a> must not play any video, but should
+ play any audio component. Media elements must not stop playing just
+ because all references to them have been removed; only once a media
+ element to which no references exist has reached a point where no
+ further audio remains to be played for that element (e.g. because
+ the element is paused, or because the end of the clip has been
+ reached, or because its <code title=dom-media-playbackRate><a href=#dom-media-playbackrate>playbackRate</a></code> is 0.0) may the
+ element be garbage collected.</p>
<hr><p>When the <a href=#current-playback-position>current playback position</a> of a <a href=#media-element>media
element</a> changes (e.g. due to playback or seeking), the user
@@ -21426,10 +21433,11 @@
list to "true" (active), and the "active" boolean of all the <a href=#cue-range title="cue range">cue ranges</a> in the <var title="">other
ranges</var> list to "false" (inactive).</li>
- </ol><p>When a <a href=#media-element>media element</a> is <span>removed from a
- <code>Document</code><!-- XXX xref removed --></span>, if the
- <a href=#media-element>media element</a>'s <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute has a
- value other than <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> then the user
+ </ol><p>When a <a href=#media-element>media element</a> is <a href=#remove-an-element-from-a-document title="remove an
+ element from a document">removed from a
+ <code>Document</code></a>, if the <a href=#media-element>media element</a>'s
+ <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute
+ has a value other than <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> then the user
agent must act as if the <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method had been invoked.</p>
<p class=note>If the <a href=#media-element>media element</a>'s
@@ -22325,9 +22333,11 @@
color is specified (e.g. when the appropriate attribute is set, or
when the method is called; not when the color is rendered or
otherwise used). If the computed value of the 'color' property is
- undefined for a particular case (e.g. because the element is not in
- a document), then the "computed value of the 'color' property" for
- the purposes of determining the computed value of the <code title="">currentColor</code> keyword is fully opaque black. <a href=#refsCSS3COLOR>[CSS3COLOR]</a></p>
+ undefined for a particular case (e.g. because the element is not
+ <a href=#in-a-document>in a <code>Document</code></a>), then the "computed value
+ of the 'color' property" for the purposes of determining the
+ computed value of the <code title="">currentColor</code> keyword is
+ fully opaque black. <a href=#refsCSS3COLOR>[CSS3COLOR]</a></p>
</div>
@@ -23850,9 +23860,10 @@
of the 'font-weight' property of the corresponding
<code><a href=#the-canvas-element>canvas</a></code> element at the time that the attribute is
set. If the computed values are undefined for a particular case
- (e.g. because the <code><a href=#the-canvas-element>canvas</a></code> element is not in a document),
- then the relative keywords must be interpreted relative to the
- normal-weight 10px sans-serif default.</p>
+ (e.g. because the <code><a href=#the-canvas-element>canvas</a></code> element is not <a href=#in-a-document>in a
+ <code>Document</code></a>), then the relative keywords must be
+ interpreted relative to the normal-weight 10px sans-serif
+ default.</p>
<p>The <dfn id=dom-context-2d-textalign title=dom-context-2d-textAlign><code>textAlign</code></dfn> DOM
attribute, on getting, must return the current value. On setting, if
Modified: source
===================================================================
--- source 2009-06-16 23:41:36 UTC (rev 3289)
+++ source 2009-06-17 00:11:38 UTC (rev 3290)
@@ -530,10 +530,18 @@
element) is the <code>Document</code> that the <code>Node</code>'s
<code title="">ownerDocument</code> DOM attribute returns.</p>
- <p>An element is said to have been <dfn title="insert an element
- into a document">inserted into a document</dfn> when its <span>root
- element</span> changes and is now the document's <span>root
- element</span>. If a <code>Node</code> is in a <code>Document</code>
+ <p>When an element's <span>root element</span> is the <span>root
+ element</span> of a <code>Document</code>, it is said to be <dfn>in
+ a <code>Document</code></dfn>. An element is said to have been <dfn
+ title="insert an element into a document">inserted into a
+ document</dfn> when its <span>root element</span> changes and is now
+ the document's <span>root element</span>. Analogously, an element is
+ said to have been <dfn title="remove an element from a
+ document">removed from a document</dfn> when its <span>root
+ element</span> changes from being the document's <span>root
+ element</span> to being another element.</p>
+
+ <p>If a <code>Node</code> is <span>in a <code>Document</code></span>
then that <code>Document</code> is always the <code>Node</code>'s
<code>Document</code>, and the <code>Node</code>'s <code
title="">ownerDocument</code> DOM attribute thus always returns that
@@ -23057,15 +23065,15 @@
<p><span title="media element">Media elements</span> that are
<span>potentially playing</span> while not <span>in a
- <code>Document</code></span><!-- XXX xref --> must not play any
- video, but should play any audio component. Media elements must not
- stop playing just because all references to them have been removed;
- only once a media element to which no references exist has reached a
- point where no further audio remains to be played for that element
- (e.g. because the element is paused, or because the end of the clip
- has been reached, or because its <code
+ <code>Document</code></span> must not play any video, but should
+ play any audio component. Media elements must not stop playing just
+ because all references to them have been removed; only once a media
+ element to which no references exist has reached a point where no
+ further audio remains to be played for that element (e.g. because
+ the element is paused, or because the end of the clip has been
+ reached, or because its <code
title="dom-media-playbackRate">playbackRate</code> is 0.0) may the
- element be <span>garbage collected</span><!-- XXX xref -->.</p>
+ element be garbage collected.</p>
<hr>
@@ -23156,11 +23164,11 @@
</ol>
- <p>When a <span>media element</span> is <span>removed from a
- <code>Document</code><!-- XXX xref removed --></span>, if the
- <span>media element</span>'s <code
- title="dom-media-networkState">networkState</code> attribute has a
- value other than <code
+ <p>When a <span>media element</span> is <span title="remove an
+ element from a document">removed from a
+ <code>Document</code></span>, if the <span>media element</span>'s
+ <code title="dom-media-networkState">networkState</code> attribute
+ has a value other than <code
title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</code> then the user
agent must act as if the <code
title="dom-media-pause">pause()</code> method had been invoked.</p>
@@ -24186,11 +24194,11 @@
color is specified (e.g. when the appropriate attribute is set, or
when the method is called; not when the color is rendered or
otherwise used). If the computed value of the 'color' property is
- undefined for a particular case (e.g. because the element is not in
- a document), then the "computed value of the 'color' property" for
- the purposes of determining the computed value of the <code
- title="">currentColor</code> keyword is fully opaque black. <a
- href="#refsCSS3COLOR">[CSS3COLOR]</a></p>
+ undefined for a particular case (e.g. because the element is not
+ <span>in a <code>Document</code></span>), then the "computed value
+ of the 'color' property" for the purposes of determining the
+ computed value of the <code title="">currentColor</code> keyword is
+ fully opaque black. <a href="#refsCSS3COLOR">[CSS3COLOR]</a></p>
</div>
@@ -26000,9 +26008,10 @@
of the 'font-weight' property of the corresponding
<code>canvas</code> element at the time that the attribute is
set. If the computed values are undefined for a particular case
- (e.g. because the <code>canvas</code> element is not in a document),
- then the relative keywords must be interpreted relative to the
- normal-weight 10px sans-serif default.</p>
+ (e.g. because the <code>canvas</code> element is not <span>in a
+ <code>Document</code></span>), then the relative keywords must be
+ interpreted relative to the normal-weight 10px sans-serif
+ default.</p>
<p>The <dfn
title="dom-context-2d-textAlign"><code>textAlign</code></dfn> DOM
More information about the Commit-Watchers
mailing list