[html5] r1879 - [e] (0) Split Window into two (editorial-level) definitions. Clean up some timeo [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Jul 15 04:17:38 PDT 2008
Author: ianh
Date: 2008-07-15 04:17:37 -0700 (Tue, 15 Jul 2008)
New Revision: 1879
Modified:
index
source
Log:
[e] (0) Split Window into two (editorial-level) definitions. Clean up some timeout stuff.
Modified: index
===================================================================
--- index 2008-07-15 10:53:59 UTC (rev 1878)
+++ index 2008-07-15 11:17:37 UTC (rev 1879)
@@ -30246,12 +30246,17 @@
<p>The <code>AbstractView</code> object of <a href="#default3"
title="default view">default views</a> must also implement the <code><a
- href="#window">Window</a></code> object.
+ href="#window">Window</a></code> and <code><a
+ href="#windowbrowsingcontext">WindowBrowsingContext</a></code> objects.
<pre class=idl>[NoInterfaceObject] interface <dfn id=window>Window</dfn> {
- // the current browsing context
+ // self-reference
readonly attribute <a href="#window">Window</a> <a href="#window0" title=dom-window>window</a>;
readonly attribute <a href="#window">Window</a> <a href="#self" title=dom-self>self</a>;
+};
+
+[NoInterfaceObject] interface <dfn id=windowbrowsingcontext>WindowBrowsingContext</dfn> {
+ // the current browsing context
attribute DOMString <a href="#name9" title=dom-name>name</a>;
[PutForwards=href] readonly attribute <a href="#location2">Location</a> <a href="#location0" title=dom-document-location>location</a>;
readonly attribute <a href="#history2">History</a> <a href="#history1" title=dom-history>history</a>;
@@ -53324,22 +53329,26 @@
<h3 id=timers><span class=secno>10.4 </span>Timers</h3>
- <p>This section is expected to be moved to the Window Object specification
- in due course.
+ <p class=big-issue>This section is expected to be moved to the Window
+ Object specification in due course.
- <pre class=idl>
-[NoInterfaceObject] interface <dfn id=windowtimers>WindowTimers</dfn> {
+ <p>Objects that implement the <code><a href="#window">Window</a></code>
+ interface must also implement the <code><a
+ href="#windowtimers">WindowTimers</a></code> interface:
+
+ <pre
+ class=idl>[NoInterfaceObject] interface <dfn id=windowtimers>WindowTimers</dfn> {
// timers
- long <a href="#settimeout">setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
- long <a href="#settimeout">setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
- long <a href="#settimeout">setTimeout</a>(in DOMString code, in long timeout);
- long <a href="#settimeout">setTimeout</a>(in DOMString code, in long timeout, in DOMString language);
- void <a href="#cleartimeout">clearTimeout</a>(in long handle);
- long <a href="#setinterval...">setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
- long <a href="#setinterval...">setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
- long <a href="#setinterval...">setInterval</a>(in DOMString code, in long timeout);
- long <a href="#setinterval...">setInterval</a>(in DOMString code, in long timeout, in DOMString language);
- void <a href="#clearinterval">clearInterval</a>(in long handle);
+ long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
+ long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
+ long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in DOMString code, in long timeout);
+ long <a href="#settimeout" title=dom-windowtimers-setTimeout>setTimeout</a>(in DOMString code, in long timeout, in DOMString language);
+ void <a href="#cleartimeout" title=dom-windowtimers-clearTimeout>clearTimeout</a>(in long handle);
+ long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout);
+ long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in <a href="#timeouthandler">TimeoutHandler</a> handler, in long timeout, <var title="">arguments...</var>);
+ long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in DOMString code, in long timeout);
+ long <a href="#setinterval..." title=dom-windowtimers-setInterval>setInterval</a>(in DOMString code, in long timeout, in DOMString language);
+ void <a href="#clearinterval" title=dom-windowtimers-clearInterval>clearInterval</a>(in long handle);
};
interface <dfn id=timeouthandler>TimeoutHandler</dfn> {
@@ -53347,18 +53356,14 @@
};
</pre>
- <p>The <code><a href="#windowtimers">WindowTimers</a></code> interface must
- be obtainable from any <code><a href="#window">Window</a></code> object
- using binding-specific casting methods.
-
- <p class=big-issue>Actually even better would be to just mix it straight
- into Window somehow.
-
- <p>The <code><a href="#settimeout">setTimeout</a></code> and <code><a
+ <p>The <code title=dom-windowtimers-setTimeout><a
+ href="#settimeout">setTimeout</a></code> and <code
+ title=dom-windowtimers-setInterval><a
href="#setinterval...">setInterval</a></code> methods allow authors to
schedule timer-based events.
- <p>The <dfn id=settimeout title=setTimeout><code>setTimeout(<var
+ <p>The <dfn id=settimeout
+ title=dom-windowtimers-setTimeout><code>setTimeout(<var
title="">handler</var>, <var title="">timeout</var>[, <var
title="">arguments...</var>])</code></dfn> method takes a reference to a
<code><a href="#timeouthandler">TimeoutHandler</a></code> object and a
@@ -53378,32 +53383,33 @@
ECMAScript if the third argument is omitted) and executed in the scope of
the <a href="#browsing1">browsing context</a> associated with the <code><a
href="#window">Window</a></code> object on which the <code
- title=setTimeout><a href="#settimeout">setTimeout()</a></code> method was
- invoked.
+ title=setTimeout>setTimeout()</code> method was invoked.
<p class=big-issue>Need to define <var title="">language</var> values.
- <p>The <dfn id=setinterval...><code>setInterval(...)</code></dfn> variants
- must work in the same way as the <code><a
- href="#settimeout">setTimeout</a></code> variants except that if <var
- title="">timeout</var> is a value greater than zero, the <var
- title="">handler</var> or <code><a href="#code">code</a></code> must be
- invoked again every <var title="">timeout</var> milliseconds, not just the
- once.</p>
- <!-- so setInterval(x) and setInterval(x, 0) are
- equivalent to setTimeout(x) and setTimeout(x, 0) respectively -->
+ <p>The <dfn id=setinterval...
+ title=dom-windowtimers-setInterval><code>setInterval(...)</code></dfn>
+ variants must work in the same way as the <code>setTimeout</code> variants
+ except that if <var title="">timeout</var> is a value greater than zero,
+ the <var title="">handler</var> or <code><a href="#code">code</a></code>
+ must be invoked again every <var title="">timeout</var> milliseconds, not
+ just the once.</p>
+ <!-- so
+ setInterval(x) and setInterval(x, 0) are equivalent to setTimeout(x)
+ and setTimeout(x, 0) respectively -->
- <p>The <dfn id=cleartimeout><code>clearTimeout()</code></dfn> and <dfn
- id=clearinterval><code>clearInterval()</code></dfn> methods take one
- integer (the value returned by <code><a
- href="#settimeout">setTimeout</a></code> and <code><a
- href="#setinterval...">setInterval</a></code> respectively) and must
- cancel the specified timeout. When called with a value that does not
- correspond to an active timeout or interval, the methods must return
- without doing anything.
+ <p>The <dfn id=cleartimeout
+ title=dom-windowtimers-clearTimeout><code>clearTimeout()</code></dfn> and
+ <dfn id=clearinterval
+ title=dom-windowtimers-clearInterval><code>clearInterval()</code></dfn>
+ methods take one integer (the value returned by <code>setTimeout</code>
+ and <code>setInterval</code> respectively) and must cancel the specified
+ timeout. When called with a value that does not correspond to an active
+ timeout or interval, the methods must return without doing anything.
<p>Timeouts must never fire while another script is executing. (Thus the
- HTML scripting model is strictly single-threaded and not reentrant.)
+ HTML scripting model is strictly single-threaded and not reentrant.)</p>
+ <!-- XXX queue -->
<h2 class=no-num id=index>Index</h2>
Modified: source
===================================================================
--- source 2008-07-15 10:53:59 UTC (rev 1878)
+++ source 2008-07-15 11:17:37 UTC (rev 1879)
@@ -27736,12 +27736,17 @@
<p>The <code>AbstractView</code> object of <span title="default
view">default views</span> must also implement the
- <code>Window</code> object.</p>
+ <code>Window</code> and <code>WindowBrowsingContext</code>
+ objects.</p>
<pre class="idl">[NoInterfaceObject] interface <dfn>Window</dfn> {
- // the current browsing context
+ // self-reference
readonly attribute <span>Window</span> <span title="dom-window">window</span>;
readonly attribute <span>Window</span> <span title="dom-self">self</span>;
+};
+
+[NoInterfaceObject] interface <dfn>WindowBrowsingContext</dfn> {
+ // the current browsing context
attribute DOMString <span title="dom-name">name</span>;
[PutForwards=href] readonly attribute <span>Location</span> <span title="dom-document-location">location</span>;
readonly attribute <span>History</span> <span title="dom-history">history</span>;
@@ -48574,22 +48579,24 @@
<h3 id="timers">Timers</h3>
- <p>This section is expected to be moved to the Window Object
- specification in due course.</p>
+ <p class="big-issue">This section is expected to be moved to the
+ Window Object specification in due course.</p>
-<pre class="idl">
-[NoInterfaceObject] interface <dfn>WindowTimers</dfn> {
+ <p>Objects that implement the <code>Window</code> interface must
+ also implement the <code>WindowTimers</code> interface:</p>
+
+<pre class="idl">[NoInterfaceObject] interface <dfn>WindowTimers</dfn> {
// timers
- long <span>setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout);
- long <span>setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
- long <span>setTimeout</span>(in DOMString code, in long timeout);
- long <span>setTimeout</span>(in DOMString code, in long timeout, in DOMString language);
- void <span>clearTimeout</span>(in long handle);
- long <span>setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout);
- long <span>setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
- long <span>setInterval</span>(in DOMString code, in long timeout);
- long <span>setInterval</span>(in DOMString code, in long timeout, in DOMString language);
- void <span>clearInterval</span>(in long handle);
+ long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout);
+ long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
+ long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in DOMString code, in long timeout);
+ long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in DOMString code, in long timeout, in DOMString language);
+ void <span title="dom-windowtimers-clearTimeout">clearTimeout</span>(in long handle);
+ long <span title="dom-windowtimers-setInterval">setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout);
+ long <span title="dom-windowtimers-setInterval">setInterval</span>(in <span>TimeoutHandler</span> handler, in long timeout, <var title="">arguments...</var>);
+ long <span title="dom-windowtimers-setInterval">setInterval</span>(in DOMString code, in long timeout);
+ long <span title="dom-windowtimers-setInterval">setInterval</span>(in DOMString code, in long timeout, in DOMString language);
+ void <span title="dom-windowtimers-clearInterval">clearInterval</span>(in long handle);
};
interface <dfn>TimeoutHandler</dfn> {
@@ -48597,17 +48604,12 @@
};
</pre>
- <p>The <code>WindowTimers</code> interface must be obtainable from
- any <code>Window</code> object using binding-specific casting
- methods.</p>
+ <p>The <code title="dom-windowtimers-setTimeout">setTimeout</code>
+ and <code title="dom-windowtimers-setInterval">setInterval</code>
+ methods allow authors to schedule timer-based events.</p>
- <p class="big-issue">Actually even better would be to just mix it
- straight into Window somehow.</p>
-
- <p>The <code>setTimeout</code> and <code>setInterval</code> methods
- allow authors to schedule timer-based events.</p>
-
- <p>The <dfn title="setTimeout"><code>setTimeout(<var
+ <p>The <dfn
+ title="dom-windowtimers-setTimeout"><code>setTimeout(<var
title="">handler</var>, <var title="">timeout</var>[, <var
title="">arguments...</var>])</code></dfn> method takes a reference
to a <code>TimeoutHandler</code> object and a length of time in
@@ -48630,27 +48632,32 @@
which the <code title="setTimeout">setTimeout()</code> method was
invoked.</p>
- <p class="big-issue">Need to define <var title="">language</var> values.</p>
+ <p class="big-issue">Need to define <var title="">language</var>
+ values.</p>
- <p>The <dfn><code>setInterval(...)</code></dfn> variants must work
- in the same way as the <code>setTimeout</code> variants except that
- if <var title="">timeout</var> is a value greater than zero, the
- <var title="">handler</var> or <code>code</code> must be invoked
- again every <var title="">timeout</var> milliseconds, not just the
- once.</p> <!-- so setInterval(x) and setInterval(x, 0) are
- equivalent to setTimeout(x) and setTimeout(x, 0) respectively -->
+ <p>The <dfn
+ title="dom-windowtimers-setInterval"><code>setInterval(...)</code></dfn>
+ variants must work in the same way as the <code>setTimeout</code>
+ variants except that if <var title="">timeout</var> is a value
+ greater than zero, the <var title="">handler</var> or
+ <code>code</code> must be invoked again every <var
+ title="">timeout</var> milliseconds, not just the once.</p> <!-- so
+ setInterval(x) and setInterval(x, 0) are equivalent to setTimeout(x)
+ and setTimeout(x, 0) respectively -->
- <p>The <dfn><code>clearTimeout()</code></dfn> and
- <dfn><code>clearInterval()</code></dfn> methods take one integer (the
- value returned by <code>setTimeout</code> and
- <code>setInterval</code> respectively) and must cancel the specified
- timeout. When called with a value that does not correspond to an
- active timeout or interval, the methods must return without doing
- anything.</p>
+ <p>The <dfn
+ title="dom-windowtimers-clearTimeout"><code>clearTimeout()</code></dfn>
+ and <dfn
+ title="dom-windowtimers-clearInterval"><code>clearInterval()</code></dfn>
+ methods take one integer (the value returned by
+ <code>setTimeout</code> and <code>setInterval</code> respectively)
+ and must cancel the specified timeout. When called with a value that
+ does not correspond to an active timeout or interval, the methods
+ must return without doing anything.</p>
<p>Timeouts must never fire while another script is executing. (Thus
the HTML scripting model is strictly single-threaded and not
- reentrant.)</p>
+ reentrant.)</p><!-- XXX queue -->
More information about the Commit-Watchers
mailing list