- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 15 Jul 2008 11:17:44 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv7111
Modified Files:
Overview.html
Log Message:
Split Window into two (editorial-level) definitions. Clean up some timeout stuff. (whatwg r1879)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1067
retrieving revision 1.1068
diff -u -d -r1.1067 -r1.1068
--- Overview.html 15 Jul 2008 10:54:03 -0000 1.1067
+++ Overview.html 15 Jul 2008 11:17:41 -0000 1.1068
@@ -30308,12 +30308,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>;
@@ -53386,22 +53391,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> {
@@ -53409,18 +53418,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
@@ -53440,32 +53445,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>
Received on Tuesday, 15 July 2008 11:18:19 UTC