- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 05 Feb 2010 23:25:57 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv26517 Modified Files: Overview.html Log Message: Move WindowProxy section to where it makes more sense. (whatwg r4667) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.3720 retrieving revision 1.3721 diff -u -d -r1.3720 -r1.3721 --- Overview.html 5 Feb 2010 23:16:46 -0000 1.3720 +++ Overview.html 5 Feb 2010 23:25:53 -0000 1.3721 @@ -873,97 +873,97 @@ <li><a href="#security-1"><span class="secno">5.1.4 </span>Security</a></li> <li><a href="#groupings-of-browsing-contexts"><span class="secno">5.1.5 </span>Groupings of browsing contexts</a></li> <li><a href="#browsing-context-names"><span class="secno">5.1.6 </span>Browsing context names</a></ol></li> - <li><a href="#the-windowproxy-object"><span class="secno">5.2 </span>The <code>WindowProxy</code> object</a></li> - <li><a href="#the-window-object"><span class="secno">5.3 </span>The <code>Window</code> object</a> + <li><a href="#the-window-object"><span class="secno">5.2 </span>The <code>Window</code> object</a> <ol> - <li><a href="#security-2"><span class="secno">5.3.1 </span>Security</a></li> - <li><a href="#apis-for-creating-and-navigating-browsing-contexts-by-name"><span class="secno">5.3.2 </span>APIs for creating and navigating browsing contexts by name</a></li> - <li><a href="#accessing-other-browsing-contexts"><span class="secno">5.3.3 </span>Accessing other browsing contexts</a></li> - <li><a href="#named-access-on-the-window-object"><span class="secno">5.3.4 </span>Named access on the <code>Window</code> object</a></li> - <li><a href="#garbage-collection-and-browsing-contexts"><span class="secno">5.3.5 </span>Garbage collection and browsing contexts</a></li> - <li><a href="#browser-interface-elements"><span class="secno">5.3.6 </span>Browser interface elements</a></ol></li> - <li><a href="#origin-0"><span class="secno">5.4 </span>Origin</a> + <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="#named-access-on-the-window-object"><span class="secno">5.2.4 </span>Named access on the <code>Window</code> object</a></li> + <li><a href="#garbage-collection-and-browsing-contexts"><span class="secno">5.2.5 </span>Garbage collection and browsing contexts</a></li> + <li><a href="#browser-interface-elements"><span class="secno">5.2.6 </span>Browser interface elements</a></li> + <li><a href="#the-windowproxy-object"><span class="secno">5.2.7 </span>The <code>WindowProxy</code> object</a></ol></li> + <li><a href="#origin-0"><span class="secno">5.3 </span>Origin</a> <ol> - <li><a href="#relaxing-the-same-origin-restriction"><span class="secno">5.4.1 </span>Relaxing the same-origin restriction</a></ol></li> - <li><a href="#scripting"><span class="secno">5.5 </span>Scripting</a> + <li><a href="#relaxing-the-same-origin-restriction"><span class="secno">5.3.1 </span>Relaxing the same-origin restriction</a></ol></li> + <li><a href="#scripting"><span class="secno">5.4 </span>Scripting</a> <ol> - <li><a href="#introduction-1"><span class="secno">5.5.1 </span>Introduction</a></li> - <li><a href="#enabling-and-disabling-scripting"><span class="secno">5.5.2 </span>Enabling and disabling scripting</a></li> - <li><a href="#processing-model-1"><span class="secno">5.5.3 </span>Processing model</a> + <li><a href="#introduction-1"><span class="secno">5.4.1 </span>Introduction</a></li> + <li><a href="#enabling-and-disabling-scripting"><span class="secno">5.4.2 </span>Enabling and disabling scripting</a></li> + <li><a href="#processing-model-1"><span class="secno">5.4.3 </span>Processing model</a> <ol> - <li><a href="#definitions-0"><span class="secno">5.5.3.1 </span>Definitions</a></li> - <li><a href="#calling-scripts"><span class="secno">5.5.3.2 </span>Calling scripts</a></li> - <li><a href="#creating-scripts"><span class="secno">5.5.3.3 </span>Creating scripts</a></li> - <li><a href="#killing-scripts"><span class="secno">5.5.3.4 </span>Killing scripts</a></ol></li> - <li><a href="#event-loops"><span class="secno">5.5.4 </span>Event loops</a> + <li><a href="#definitions-0"><span class="secno">5.4.3.1 </span>Definitions</a></li> + <li><a href="#calling-scripts"><span class="secno">5.4.3.2 </span>Calling scripts</a></li> + <li><a href="#creating-scripts"><span class="secno">5.4.3.3 </span>Creating scripts</a></li> + <li><a href="#killing-scripts"><span class="secno">5.4.3.4 </span>Killing scripts</a></ol></li> + <li><a href="#event-loops"><span class="secno">5.4.4 </span>Event loops</a> <ol> - <li><a href="#definitions-1"><span class="secno">5.5.4.1 </span>Definitions</a></li> - <li><a href="#processing-model-2"><span class="secno">5.5.4.2 </span>Processing model</a></li> - <li><a href="#generic-task-sources"><span class="secno">5.5.4.3 </span>Generic task sources</a></ol></li> - <li><a href="#javascript-protocol"><span class="secno">5.5.5 </span>The <code title="">javascript:</code> protocol</a></li> - <li><a href="#events"><span class="secno">5.5.6 </span>Events</a> + <li><a href="#definitions-1"><span class="secno">5.4.4.1 </span>Definitions</a></li> + <li><a href="#processing-model-2"><span class="secno">5.4.4.2 </span>Processing model</a></li> + <li><a href="#generic-task-sources"><span class="secno">5.4.4.3 </span>Generic task sources</a></ol></li> + <li><a href="#javascript-protocol"><span class="secno">5.4.5 </span>The <code title="">javascript:</code> protocol</a></li> + <li><a href="#events"><span class="secno">5.4.6 </span>Events</a> <ol> - <li><a href="#event-handler-attributes"><span class="secno">5.5.6.1 </span>Event handlers</a></li> - <li><a href="#event-handlers-on-elements-document-objects-and-window-objects"><span class="secno">5.5.6.2 </span>Event handlers on elements, <code>Document</code> objects, and <code>Window</code> objects</a></li> - <li><a href="#event-firing"><span class="secno">5.5.6.3 </span>Event firing</a></li> - <li><a href="#events-and-the-window-object"><span class="secno">5.5.6.4 </span>Events and the <code>Window</code> object</a></li> - <li><a href="#runtime-script-errors"><span class="secno">5.5.6.5 </span>Runtime script errors</a></ol></ol></li> - <li><a href="#timers"><span class="secno">5.6 </span>Timers</a></li> - <li><a href="#user-prompts"><span class="secno">5.7 </span>User prompts</a> + <li><a href="#event-handler-attributes"><span class="secno">5.4.6.1 </span>Event handlers</a></li> + <li><a href="#event-handlers-on-elements-document-objects-and-window-objects"><span class="secno">5.4.6.2 </span>Event handlers on elements, <code>Document</code> objects, and <code>Window</code> objects</a></li> + <li><a href="#event-firing"><span class="secno">5.4.6.3 </span>Event firing</a></li> + <li><a href="#events-and-the-window-object"><span class="secno">5.4.6.4 </span>Events and the <code>Window</code> object</a></li> + <li><a href="#runtime-script-errors"><span class="secno">5.4.6.5 </span>Runtime script errors</a></ol></ol></li> + <li><a href="#timers"><span class="secno">5.5 </span>Timers</a></li> + <li><a href="#user-prompts"><span class="secno">5.6 </span>User prompts</a> <ol> - <li><a href="#simple-dialogs"><span class="secno">5.7.1 </span>Simple dialogs</a></li> - <li><a href="#printing"><span class="secno">5.7.2 </span>Printing</a></li> - <li><a href="#dialogs-implemented-using-separate-documents"><span class="secno">5.7.3 </span>Dialogs implemented using separate documents</a></ol></li> - <li><a href="#system-state-and-capabilities"><span class="secno">5.8 </span>System state and capabilities</a> + <li><a href="#simple-dialogs"><span class="secno">5.6.1 </span>Simple dialogs</a></li> + <li><a href="#printing"><span class="secno">5.6.2 </span>Printing</a></li> + <li><a href="#dialogs-implemented-using-separate-documents"><span class="secno">5.6.3 </span>Dialogs implemented using separate documents</a></ol></li> + <li><a href="#system-state-and-capabilities"><span class="secno">5.7 </span>System state and capabilities</a> <ol> - <li><a href="#client-identification"><span class="secno">5.8.1 </span>Client identification</a></li> - <li><a href="#custom-handlers"><span class="secno">5.8.2 </span>Custom scheme and content handlers</a> + <li><a href="#client-identification"><span class="secno">5.7.1 </span>Client identification</a></li> + <li><a href="#custom-handlers"><span class="secno">5.7.2 </span>Custom scheme and content handlers</a> <ol> - <li><a href="#security-and-privacy"><span class="secno">5.8.2.1 </span>Security and privacy</a></li> - <li><a href="#sample-handler-impl"><span class="secno">5.8.2.2 </span>Sample user interface</a></ol></li> - <li><a href="#manually-releasing-the-storage-mutex"><span class="secno">5.8.3 </span>Manually releasing the storage mutex</a></ol></li> - <li><a href="#offline"><span class="secno">5.9 </span>Offline Web applications</a> + <li><a href="#security-and-privacy"><span class="secno">5.7.2.1 </span>Security and privacy</a></li> + <li><a href="#sample-handler-impl"><span class="secno">5.7.2.2 </span>Sample user interface</a></ol></li> + <li><a href="#manually-releasing-the-storage-mutex"><span class="secno">5.7.3 </span>Manually releasing the storage mutex</a></ol></li> + <li><a href="#offline"><span class="secno">5.8 </span>Offline Web applications</a> <ol> - <li><a href="#introduction-2"><span class="secno">5.9.1 </span>Introduction</a> + <li><a href="#introduction-2"><span class="secno">5.8.1 </span>Introduction</a> <ol> - <li><a href="#appcacheevents"><span class="secno">5.9.1.1 </span>Event summary</a></ol></li> - <li><a href="#appcache"><span class="secno">5.9.2 </span>Application caches</a></li> - <li><a href="#manifests"><span class="secno">5.9.3 </span>The cache manifest syntax</a> + <li><a href="#appcacheevents"><span class="secno">5.8.1.1 </span>Event summary</a></ol></li> + <li><a href="#appcache"><span class="secno">5.8.2 </span>Application caches</a></li> + <li><a href="#manifests"><span class="secno">5.8.3 </span>The cache manifest syntax</a> <ol> - <li><a href="#a-sample-manifest"><span class="secno">5.9.3.1 </span>A sample manifest</a></li> - <li><a href="#writing-cache-manifests"><span class="secno">5.9.3.2 </span>Writing cache manifests</a></li> - <li><a href="#parsing-cache-manifests"><span class="secno">5.9.3.3 </span>Parsing cache manifests</a></ol></li> - <li><a href="#downloading-or-updating-an-application-cache"><span class="secno">5.9.4 </span>Downloading or updating an application cache</a></li> - <li><a href="#the-application-cache-selection-algorithm"><span class="secno">5.9.5 </span>The application cache selection algorithm</a></li> - <li><a href="#changesToNetworkingModel"><span class="secno">5.9.6 </span>Changes to the networking model</a></li> - <li><a href="#expiring-application-caches"><span class="secno">5.9.7 </span>Expiring application caches</a></li> - <li><a href="#application-cache-api"><span class="secno">5.9.8 </span>Application cache API</a></li> - <li><a href="#browser-state"><span class="secno">5.9.9 </span>Browser state</a></ol></li> - <li><a href="#history"><span class="secno">5.10 </span>Session history and navigation</a> + <li><a href="#a-sample-manifest"><span class="secno">5.8.3.1 </span>A sample manifest</a></li> + <li><a href="#writing-cache-manifests"><span class="secno">5.8.3.2 </span>Writing cache manifests</a></li> + <li><a href="#parsing-cache-manifests"><span class="secno">5.8.3.3 </span>Parsing cache manifests</a></ol></li> + <li><a href="#downloading-or-updating-an-application-cache"><span class="secno">5.8.4 </span>Downloading or updating an application cache</a></li> + <li><a href="#the-application-cache-selection-algorithm"><span class="secno">5.8.5 </span>The application cache selection algorithm</a></li> + <li><a href="#changesToNetworkingModel"><span class="secno">5.8.6 </span>Changes to the networking model</a></li> + <li><a href="#expiring-application-caches"><span class="secno">5.8.7 </span>Expiring application caches</a></li> + <li><a href="#application-cache-api"><span class="secno">5.8.8 </span>Application cache API</a></li> + <li><a href="#browser-state"><span class="secno">5.8.9 </span>Browser state</a></ol></li> + <li><a href="#history"><span class="secno">5.9 </span>Session history and navigation</a> <ol> - <li><a href="#the-session-history-of-browsing-contexts"><span class="secno">5.10.1 </span>The session history of browsing contexts</a></li> - <li><a href="#the-history-interface"><span class="secno">5.10.2 </span>The <code>History</code> interface</a></li> - <li><a href="#the-location-interface"><span class="secno">5.10.3 </span>The <code>Location</code> interface</a> + <li><a href="#the-session-history-of-browsing-contexts"><span class="secno">5.9.1 </span>The session history of browsing contexts</a></li> + <li><a href="#the-history-interface"><span class="secno">5.9.2 </span>The <code>History</code> interface</a></li> + <li><a href="#the-location-interface"><span class="secno">5.9.3 </span>The <code>Location</code> interface</a> <ol> - <li><a href="#security-3"><span class="secno">5.10.3.1 </span>Security</a></ol></li> - <li><a href="#history-notes"><span class="secno">5.10.4 </span>Implementation notes for session history</a></ol></li> - <li><a href="#browsing-the-web"><span class="secno">5.11 </span>Browsing the Web</a> + <li><a href="#security-3"><span class="secno">5.9.3.1 </span>Security</a></ol></li> + <li><a href="#history-notes"><span class="secno">5.9.4 </span>Implementation notes for session history</a></ol></li> + <li><a href="#browsing-the-web"><span class="secno">5.10 </span>Browsing the Web</a> <ol> - <li><a href="#navigating-across-documents"><span class="secno">5.11.1 </span>Navigating across documents</a></li> - <li><a href="#read-html"><span class="secno">5.11.2 </span>Page load processing model for HTML files</a></li> - <li><a href="#read-xml"><span class="secno">5.11.3 </span>Page load processing model for XML files</a></li> - <li><a href="#read-text"><span class="secno">5.11.4 </span>Page load processing model for text files</a></li> - <li><a href="#read-image"><span class="secno">5.11.5 </span>Page load processing model for images</a></li> - <li><a href="#read-plugin"><span class="secno">5.11.6 </span>Page load processing model for content that uses plugins</a></li> - <li><a href="#read-ua-inline"><span class="secno">5.11.7 </span>Page load processing model for inline content that doesn't have a DOM</a></li> - <li><a href="#scroll-to-fragid"><span class="secno">5.11.8 </span>Navigating to a fragment identifier</a></li> - <li><a href="#history-traversal"><span class="secno">5.11.9 </span>History traversal</a> + <li><a href="#navigating-across-documents"><span class="secno">5.10.1 </span>Navigating across documents</a></li> + <li><a href="#read-html"><span class="secno">5.10.2 </span>Page load processing model for HTML files</a></li> + <li><a href="#read-xml"><span class="secno">5.10.3 </span>Page load processing model for XML files</a></li> + <li><a href="#read-text"><span class="secno">5.10.4 </span>Page load processing model for text files</a></li> + <li><a href="#read-image"><span class="secno">5.10.5 </span>Page load processing model for images</a></li> + <li><a href="#read-plugin"><span class="secno">5.10.6 </span>Page load processing model for content that uses plugins</a></li> + <li><a href="#read-ua-inline"><span class="secno">5.10.7 </span>Page load processing model for inline content that doesn't have a DOM</a></li> + <li><a href="#scroll-to-fragid"><span class="secno">5.10.8 </span>Navigating to a fragment identifier</a></li> + <li><a href="#history-traversal"><span class="secno">5.10.9 </span>History traversal</a> <ol> - <li><a href="#event-definitions"><span class="secno">5.11.9.1 </span>Event definitions</a></ol></li> - <li><a href="#unloading-documents"><span class="secno">5.11.10 </span>Unloading documents</a> + <li><a href="#event-definitions"><span class="secno">5.10.9.1 </span>Event definitions</a></ol></li> + <li><a href="#unloading-documents"><span class="secno">5.10.10 </span>Unloading documents</a> <ol> - <li><a href="#event-definition"><span class="secno">5.11.10.1 </span>Event definition</a></ol></li> - <li><a href="#aborting-a-document-load"><span class="secno">5.11.11 </span>Aborting a document load</a></ol></ol></li> + <li><a href="#event-definition"><span class="secno">5.10.10.1 </span>Event definition</a></ol></li> + <li><a href="#aborting-a-document-load"><span class="secno">5.10.11 </span>Aborting a document load</a></ol></ol></li> <li><a href="#editing"><span class="secno">6 </span>User Interaction</a> <ol> <li><a href="#the-hidden-attribute"><span class="secno">6.1 </span>The <code>hidden</code> attribute</a></li> @@ -39092,41 +39092,7 @@ </li> - </ol></div><div class="impl"> - - <h3 id="the-windowproxy-object"><span class="secno">5.2 </span>The <code><a href="#windowproxy">WindowProxy</a></code> object</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> - - - <p>As mentioned earlier, each <a href="#browsing-context">browsing context</a> has a - <dfn id="windowproxy"><code>WindowProxy</code></dfn> object. This object is unusual - in that all operations that would be performed on it must be - performed on the <code><a href="#window">Window</a></code> object of the <a href="#browsing-context">browsing - context</a>'s <a href="#active-document">active document</a> instead. It is thus - indistinguishable from that <code><a href="#window">Window</a></code> object in every way - until the <a href="#browsing-context">browsing context</a> is navigated.</p> - - <p>There is no <code><a href="#windowproxy">WindowProxy</a></code> interface object.</p> - - <p class="note">The <code><a href="#windowproxy">WindowProxy</a></code> object allows scripts - to act as if each <a href="#browsing-context">browsing context</a> had a single - <code><a href="#window">Window</a></code> object, while still keeping separate - <code><a href="#window">Window</a></code> objects for each <code>Document</code>.</p> - - <div class="example"> - - <p>In the following example, the variable <var title="">x</var> is - set to the <code><a href="#windowproxy">WindowProxy</a></code> object returned by the <code title="dom-window"><a href="#dom-window">window</a></code> accessor on the global object. All - of the expressions following the assignment return true, because in - every respect, the <code><a href="#windowproxy">WindowProxy</a></code> object acts like the - underlying <code><a href="#window">Window</a></code> object.</p> - - <pre>var x = window; -x instanceof Window; // true -x === this; // true</pre> - - </div> - - </div><h3 id="the-window-object"><span class="secno">5.3 </span>The <code><a href="#window">Window</a></code> object</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">[OverrideBuiltins, ReplaceableNamedProperties] <!-- XXX http://www.w3.org/Bugs/Public/show_bug.cgi?id=8241 --> + </ol></div><h3 id="the-window-object"><span class="secno">5.2 </span>The <code><a href="#window">Window</a></code> object</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">[OverrideBuiltins, ReplaceableNamedProperties] <!-- XXX http://www.w3.org/Bugs/Public/show_bug.cgi?id=8241 --> interface <dfn id="window">Window</dfn> { // the current browsing context readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-window" title="dom-window">window</a>; @@ -39263,7 +39229,7 @@ </div><div class="impl"> - <h4 id="security-2"><span class="secno">5.3.1 </span>Security</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="security-2"><span class="secno">5.2.1 </span>Security</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>User agents must raise a <code><a href="#security_err">SECURITY_ERR</a></code> exception whenever any of the members of a <code><a href="#window">Window</a></code> object are @@ -39310,7 +39276,7 @@ </div> - </div><h4 id="apis-for-creating-and-navigating-browsing-contexts-by-name"><span class="secno">5.3.2 </span>APIs for creating and navigating browsing contexts by name</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> = <var title="">window</var> . <code title="dom-open"><a href="#dom-open">open</a></code>( [ <var title="">url</var> [, <var title="">target</var> [, <var title="">features</var> [, <var title="">replace</var> ] ] ] ] )</dt> + </div><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 class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> = <var title="">window</var> . <code title="dom-open"><a href="#dom-open">open</a></code>( [ <var title="">url</var> [, <var title="">target</var> [, <var title="">features</var> [, <var title="">replace</var> ] ] ] ] )</dt> <dd> @@ -39429,7 +39395,7 @@ context</a> <var title="">A</var> (and may <a href="#a-browsing-context-is-discarded" title="a browsing context is discarded">discard</a> it too).</p> - </div><h4 id="accessing-other-browsing-contexts"><span class="secno">5.3.3 </span>Accessing other browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-length"><a href="#dom-length">length</a></code></dt> + </div><h4 id="accessing-other-browsing-contexts"><span class="secno">5.2.3 </span>Accessing other browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-length"><a href="#dom-length">length</a></code></dt> <dd> @@ -39478,7 +39444,7 @@ <p>These properties are the <dfn id="dynamic-nested-browsing-context-properties">dynamic nested browsing context properties</dfn>.</p> - </div><h4 id="named-access-on-the-window-object"><span class="secno">5.3.4 </span>Named access on the <code><a href="#window">Window</a></code> object</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var>[<var title="">name</var>]</dt> + </div><h4 id="named-access-on-the-window-object"><span class="secno">5.2.4 </span>Named access on the <code><a href="#window">Window</a></code> object</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var>[<var title="">name</var>]</dt> <dd> @@ -39557,7 +39523,7 @@ </ul></div><div class="impl"> - <h4 id="garbage-collection-and-browsing-contexts"><span class="secno">5.3.5 </span>Garbage collection and browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="garbage-collection-and-browsing-contexts"><span class="secno">5.2.5 </span>Garbage collection and browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>A <a href="#browsing-context">browsing context</a> has a strong reference to each of its <code>Document</code>s and its <code><a href="#windowproxy">WindowProxy</a></code> object, @@ -39604,7 +39570,7 @@ once their <code><a href="#windowproxy">WindowProxy</a></code> object is eligible for garbage collection.</p> - </div><h4 id="browser-interface-elements"><span class="secno">5.3.6 </span>Browser interface elements</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>To allow Web pages to integrate with Web browsers, certain Web + </div><h4 id="browser-interface-elements"><span class="secno">5.2.6 </span>Browser interface elements</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>To allow Web pages to integrate with Web browsers, certain Web browser interface elements are exposed in a limited way to scripts in Web pages.<p>Each interface element is represented by a <code><a href="#barprop">BarProp</a></code> object:<pre class="idl">interface <dfn id="barprop">BarProp</dfn> { @@ -39728,7 +39694,41 @@ </div><div class="impl"> - <h3 id="origin-0"><span class="secno">5.4 </span>Origin</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="the-windowproxy-object"><span class="secno">5.2.7 </span>The <code><a href="#windowproxy">WindowProxy</a></code> object</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + + + <p>As mentioned earlier, each <a href="#browsing-context">browsing context</a> has a + <dfn id="windowproxy"><code>WindowProxy</code></dfn> object. This object is unusual + in that all operations that would be performed on it must be + performed on the <code><a href="#window">Window</a></code> object of the <a href="#browsing-context">browsing + context</a>'s <a href="#active-document">active document</a> instead. It is thus + indistinguishable from that <code><a href="#window">Window</a></code> object in every way + until the <a href="#browsing-context">browsing context</a> is navigated.</p> + + <p>There is no <code><a href="#windowproxy">WindowProxy</a></code> interface object.</p> + + <p class="note">The <code><a href="#windowproxy">WindowProxy</a></code> object allows scripts + to act as if each <a href="#browsing-context">browsing context</a> had a single + <code><a href="#window">Window</a></code> object, while still keeping separate + <code><a href="#window">Window</a></code> objects for each <code>Document</code>.</p> + + <div class="example"> + + <p>In the following example, the variable <var title="">x</var> is + set to the <code><a href="#windowproxy">WindowProxy</a></code> object returned by the <code title="dom-window"><a href="#dom-window">window</a></code> accessor on the global object. All + of the expressions following the assignment return true, because in + every respect, the <code><a href="#windowproxy">WindowProxy</a></code> object acts like the + underlying <code><a href="#window">Window</a></code> object.</p> + + <pre>var x = window; +x instanceof Window; // true +x === this; // true</pre> + + </div> + + </div><div class="impl"> + + <h3 id="origin-0"><span class="secno">5.3 </span>Origin</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <!-- Hallowed are the Ori --> <p>The <dfn id="origin">origin</dfn> of a resource and the <dfn id="effective-script-origin">effective script @@ -40080,7 +40080,7 @@ <li><p>Return true.</li> - </ol></div><h4 id="relaxing-the-same-origin-restriction"><span class="secno">5.4.1 </span>Relaxing the same-origin restriction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-domain"><a href="#dom-document-domain">domain</a></code> [ = <var title="">domain</var> ]</dt> + </ol></div><h4 id="relaxing-the-same-origin-restriction"><span class="secno">5.3.1 </span>Relaxing the same-origin restriction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-domain"><a href="#dom-document-domain">domain</a></code> [ = <var title="">domain</var> ]</dt> <dd> @@ -40209,7 +40209,7 @@ same-origin protection that normally protects two different sites on the same host will fail, as the ports are ignored when comparing origins after the <code title="dom-document-domain"><a href="#dom-document-domain">document.domain</a></code> attribute has - been used.<h3 id="scripting"><span class="secno">5.5 </span>Scripting</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h4 id="introduction-1"><span class="secno">5.5.1 </span>Introduction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Various mechanisms can cause author-provided executable code to + been used.<h3 id="scripting"><span class="secno">5.4 </span>Scripting</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h4 id="introduction-1"><span class="secno">5.4.1 </span>Introduction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Various mechanisms can cause author-provided executable code to run in the context of a document. These mechanisms include, but are probably not limited to:<ul><li>Processing of <code><a href="#script">script</a></code> elements.</li> @@ -40227,7 +40227,7 @@ </ul><div class="impl"> - <h4 id="enabling-and-disabling-scripting"><span class="secno">5.5.2 </span>Enabling and disabling scripting</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="enabling-and-disabling-scripting"><span class="secno">5.4.2 </span>Enabling and disabling scripting</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p><dfn id="concept-bc-script" title="concept-bc-script">Scripting is enabled</dfn> in a <em><a href="#browsing-context">browsing context</a></em> when all of the @@ -40262,9 +40262,9 @@ </div><div class="impl"> <!-- SCRIPT EXEC (marks areas related to creation of scripts) --> - <h4 id="processing-model-1"><span class="secno">5.5.3 </span>Processing model</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="processing-model-1"><span class="secno">5.4.3 </span>Processing model</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> - <h5 id="definitions-0"><span class="secno">5.5.3.1 </span>Definitions</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="definitions-0"><span class="secno">5.4.3.1 </span>Definitions</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>A <dfn id="concept-script" title="concept-script">script</dfn> has:</p> @@ -40377,7 +40377,7 @@ </dl></div><div class="impl"> - <h5 id="calling-scripts"><span class="secno">5.5.3.2 </span>Calling scripts</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="calling-scripts"><span class="secno">5.4.3.2 </span>Calling scripts</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When a user agent is to <dfn id="jump-to-a-code-entry-point">jump to a code entry-point</dfn> for a <a href="#concept-script" title="concept-script">script</a>, for example to invoke @@ -40402,7 +40402,7 @@ </div><div class="impl"> - <h5 id="creating-scripts"><span class="secno">5.5.3.3 </span>Creating scripts</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="creating-scripts"><span class="secno">5.4.3.3 </span>Creating scripts</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When the specification says that a <a href="#concept-script" title="concept-script">script</a> is to be <dfn id="create-a-script" title="create a script">created</dfn>, given some script source, its scripting @@ -40471,7 +40471,7 @@ </ol></div><div class="impl"> - <h5 id="killing-scripts"><span class="secno">5.5.3.4 </span>Killing scripts</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="killing-scripts"><span class="secno">5.4.3.4 </span>Killing scripts</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>User agents may impose resource limitations on scripts, for example CPU quotas, memory limits, total execution time limits, or @@ -40502,9 +40502,9 @@ </div><div class="impl"> - <h4 id="event-loops"><span class="secno">5.5.4 </span>Event loops</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="event-loops"><span class="secno">5.4.4 </span>Event loops</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> - <h5 id="definitions-1"><span class="secno">5.5.4.1 </span>Definitions</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="definitions-1"><span class="secno">5.4.4.1 </span>Definitions</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>To coordinate events, user interaction, scripts, rendering, networking, and so forth, user agents must use <dfn id="event-loop" title="event @@ -40610,7 +40610,7 @@ release the <a href="#storage-mutex">storage mutex</a>.</p> - <h5 id="processing-model-2"><span class="secno">5.5.4.2 </span>Processing model</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="processing-model-2"><span class="secno">5.4.4.2 </span>Processing model</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>An <a href="#event-loop">event loop</a> must continually run through the following steps for as long as it exists:</p> @@ -40691,7 +40691,7 @@ </ol></div><div class="impl"> - <h5 id="generic-task-sources"><span class="secno">5.5.4.3 </span>Generic task sources</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="generic-task-sources"><span class="secno">5.4.4.3 </span>Generic task sources</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>The following <a href="#task-source" title="task source">task sources</a> are used by a number of mostly unrelated features in this and other @@ -40752,7 +40752,7 @@ </dl></div><div class="impl"> <!-- SCRIPT EXEC --> - <h4 id="javascript-protocol"><span class="secno">5.5.5 </span><dfn title="javascript protocol">The <code title="">javascript:</code> protocol</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="javascript-protocol"><span class="secno">5.4.5 </span><dfn title="javascript protocol">The <code title="">javascript:</code> protocol</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When a <a href="#url">URL</a> using the <code title="">javascript:</code> protocol is <dfn id="concept-js-deref" title="concept-js-deref">dereferenced</dfn>, the user agent must run the following steps:</p> @@ -40867,9 +40867,9 @@ </div> - </div><h4 id="events"><span class="secno">5.5.6 </span>Events</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> + </div><h4 id="events"><span class="secno">5.4.6 </span>Events</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> - <h5 id="event-handler-attributes"><span class="secno">5.5.6.1 </span>Event handlers</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="event-handler-attributes"><span class="secno">5.4.6.1 </span>Event handlers</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> </div><!--test: <a href="http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0A...%3Cscript%3E%0Aw(a%3Ddocument.implementation.createDocument(null%2C%20null%2C%20null))%3B%0Aw(a.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'html')))%3B%0Aw(b%3Da.firstChild.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'body')))%3B%0Aw(b.test%20%3D%20w)%3B%0Aw(b.setAttribute('onclick'%2C%20'test(%22fire%3A%20%22%20%2B%20event)'))%3B%0Aw(b.onclick)%3B%0Aw(e%3Da.createEvent('Event'))%3B%0Aw(e.initEvent('click'%2C%20false%2C%20false))%3B%0Aw(b.dispatchEvent(e))%3B%0A%3C%2Fscript%3E">test</a>--><p>Many objects can have <dfn id="event-handlers">event handlers</dfn> specified. These act as bubbling event listeners for the object on which they are @@ -41074,7 +41074,7 @@ value has to be true to cancel the event). With <code title="event-beforeunload">beforeunload</code> events, the value is instead used to determine the message to show the user.<div class="impl"> - <h5 id="event-handlers-on-elements-document-objects-and-window-objects"><span class="secno">5.5.6.2 </span>Event handlers on elements, <code>Document</code> objects, and <code><a href="#window">Window</a></code> objects</h5> + <h5 id="event-handlers-on-elements-document-objects-and-window-objects"><span class="secno">5.4.6.2 </span>Event handlers on elements, <code>Document</code> objects, and <code><a href="#window">Window</a></code> objects</h5> <p>The following are the <a href="#event-handlers">event handlers</a> (and their corresponding <a href="#event-handler-event-type" title="event handler event type">event handler @@ -41185,7 +41185,7 @@ </div><div class="impl"> - <h5 id="event-firing"><span class="secno">5.5.6.3 </span>Event firing</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="event-firing"><span class="secno">5.4.6.3 </span>Event firing</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>Certain operations and methods are defined as firing events on elements. For example, the <code title="dom-click"><a href="#dom-click">click()</a></code> @@ -41246,7 +41246,7 @@ </div><div class="impl"> - <h5 id="events-and-the-window-object"><span class="secno">5.5.6.4 </span>Events and the <code><a href="#window">Window</a></code> object</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="events-and-the-window-object"><span class="secno">5.4.6.4 </span>Events and the <code><a href="#window">Window</a></code> object</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When an event is dispatched at a DOM node in a <code>Document</code> in a <a href="#browsing-context">browsing context</a>, if the @@ -41266,7 +41266,7 @@ </ol></div><div class="impl"> - <h5 id="runtime-script-errors"><span class="secno">5.5.6.5 </span>Runtime script errors</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="runtime-script-errors"><span class="secno">5.4.6.5 </span>Runtime script errors</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p><i>This section only applies to user agents that support scripting in general and JavaScript in particular.</i></p> @@ -41313,7 +41313,7 @@ </dd> - </dl></div><h3 id="timers"><span class="secno">5.6 </span>Timers</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="dom-windowtimers-setTimeout"><a href="#dom-windowtimers-settimeout">setTimeout()</a></code> + </dl></div><h3 id="timers"><span class="secno">5.5 </span>Timers</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <code title="dom-windowtimers-setTimeout"><a href="#dom-windowtimers-settimeout">setTimeout()</a></code> and <code title="dom-windowtimers-setInterval"><a href="#dom-windowtimers-setinterval">setInterval()</a></code> methods allow authors to schedule timer-based callbacks.<pre class="idl">[Supplemental, NoInterfaceObject] interface <dfn id="windowtimers">WindowTimers</dfn> { @@ -41583,14 +41583,14 @@ </ol><hr><p>The <a href="#task-source">task source</a> for these <a href="#concept-task" title="concept-task">tasks</a> is the <dfn id="timer-task-source">timer task source</dfn>.</p> - </div><h3 id="user-prompts"><span class="secno">5.7 </span>User prompts</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- + </div><h3 id="user-prompts"><span class="secno">5.6 </span>User prompts</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 ideas: * in-window modal dialogs - escape/enter handling - dragging the window out of the tab * in-window non-modal palettes - with a solution for the mobile space - --><h4 id="simple-dialogs"><span class="secno">5.7.1 </span>Simple dialogs</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-alert"><a href="#dom-alert">alert</a></code>(<var title="">message</var>)</dt> + --><h4 id="simple-dialogs"><span class="secno">5.6.1 </span>Simple dialogs</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-alert"><a href="#dom-alert">alert</a></code>(<var title="">message</var>)</dt> <dd> <p>Displays a modal alert with the given message, and waits for the user to dismiss it.</p> @@ -41652,7 +41652,7 @@ user aborts, then the method must return null; otherwise, the method must return the string that the user responded with.</p> - </div><h4 id="printing"><span class="secno">5.7.2 </span>Printing</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-print"><a href="#dom-print">print</a></code>()</dt> + </div><h4 id="printing"><span class="secno">5.6.2 </span>Printing</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-print"><a href="#dom-print">print</a></code>()</dt> <dd> @@ -41741,7 +41741,7 @@ </li> - </ol></div><h4 id="dialogs-implemented-using-separate-documents"><span class="secno">5.7.3 </span>Dialogs implemented using separate documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">result</var> = <var title="">window</var> . <code title="dom-showModalDialog"><a href="#dom-showmodaldialog">showModalDialog</a></code>(<var title="">url</var> [, <var title="">argument</var>] )</dt> + </ol></div><h4 id="dialogs-implemented-using-separate-documents"><span class="secno">5.6.3 </span>Dialogs implemented using separate documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">result</var> = <var title="">window</var> . <code title="dom-showModalDialog"><a href="#dom-showmodaldialog">showModalDialog</a></code>(<var title="">url</var> [, <var title="">argument</var>] )</dt> <dd> @@ -41945,7 +41945,7 @@ value</a> to the given new value.</p> </div><p class="note">The <code title="dom-window-close"><a href="#dom-window-close">window.close()</a></code> method can be used to - close the browsing context.<h3 id="system-state-and-capabilities"><span class="secno">5.8 </span>System state and capabilities</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> + close the browsing context.<h3 id="system-state-and-capabilities"><span class="secno">5.7 </span>System state and capabilities</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> <p>The <dfn id="dom-navigator" title="dom-navigator"><code>navigator</code></dfn> attribute of the <code><a href="#window">Window</a></code> interface must return an @@ -42001,7 +42001,7 @@ <dd><p>Must return either null or a language code representing the user's preferred language.</p></dd> --> - </div><h4 id="client-identification"><span class="secno">5.8.1 </span>Client identification</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>In certain cases, despite the best efforts of the entire + </div><h4 id="client-identification"><span class="secno">5.7.1 </span>Client identification</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>In certain cases, despite the best efforts of the entire industry, Web browsers have bugs and limitations that Web authors are forced to work around.<p>This section defines a collection of attributes that can be used to determine, from script, the kind of user agent in use, in order @@ -42060,7 +42060,7 @@ <!-- vendorSub: Mozilla and Safari only; always returns "" --> - </dl></div><h4 id="custom-handlers"><span class="secno">5.8.2 </span>Custom scheme and content handlers</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="dom-navigator-registerprotocolhandler" title="dom-navigator-registerProtocolHandler"><code>registerProtocolHandler()</code></dfn> + </dl></div><h4 id="custom-handlers"><span class="secno">5.7.2 </span>Custom scheme and content handlers</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="dom-navigator-registerprotocolhandler" title="dom-navigator-registerProtocolHandler"><code>registerProtocolHandler()</code></dfn> method allows Web sites to register themselves as possible handlers for particular schemes. For example, an online fax service could register itself as a handler of the <code>fax:</code> scheme (<a href="#refsRFC2806">[RFC2806]</a>), so that if the user clicks on @@ -42245,7 +42245,7 @@ </div><div class="impl"> - <h5 id="security-and-privacy"><span class="secno">5.8.2.1 </span>Security and privacy</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="security-and-privacy"><span class="secno">5.7.2.1 </span>Security and privacy</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>These mechanisms can introduce a number of concerns, in particular privacy concerns.</p> @@ -42326,7 +42326,7 @@ </div><div class="impl"> - <h5 id="sample-handler-impl"><span class="secno">5.8.2.2 </span>Sample user interface</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="sample-handler-impl"><span class="secno">5.7.2.2 </span>Sample user interface</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p><i>This section is non-normative.</i></p> @@ -42368,7 +42368,7 @@ method would work equivalently, but for schemes instead of unknown content types.</p> - </div><h4 id="manually-releasing-the-storage-mutex"><span class="secno">5.8.3 </span>Manually releasing the storage mutex</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">yieldForStorageUpdates</a></code>()</dt> + </div><h4 id="manually-releasing-the-storage-mutex"><span class="secno">5.7.3 </span>Manually releasing the storage mutex</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">yieldForStorageUpdates</a></code>()</dt> <dd> @@ -42395,7 +42395,7 @@ called, release the <a href="#storage-mutex">storage mutex</a> so that it is once again free. Otherwise, it must do nothing.</p> - </div><h3 id="offline"><span class="secno">5.9 </span>Offline Web applications</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 ideas for appcache: + </div><h3 id="offline"><span class="secno">5.8 </span>Offline Web applications</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 ideas for appcache: * A way to limit what gets download when the user agent is updating the application cache and it turns out the server has @@ -42435,7 +42435,7 @@ else by just making the script pick the other user's variant, and then reloading. - --><h4 id="introduction-2"><span class="secno">5.9.1 </span>Introduction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>In order to enable users to continue interacting with Web + --><h4 id="introduction-2"><span class="secno">5.8.1 </span>Introduction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>In order to enable users to continue interacting with Web applications and documents even when their network connection is unavailable — for instance, because they are traveling outside of their ISP's coverage area — authors can provide a manifest @@ -42484,7 +42484,7 @@ served over TLS (encrypted, using <code title="">https:</code>) are overridden by manifests. Thus, pages will not expire from an application cache before the user agent has updated it, and even - applications served over TLS can be made to work offline.<h5 id="appcacheevents"><span class="secno">5.9.1.1 </span>Event summary</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>When the user visits a page that declares a manifest, the browser + applications served over TLS can be made to work offline.<h5 id="appcacheevents"><span class="secno">5.8.1.1 </span>Event summary</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>When the user visits a page that declares a manifest, the browser will try to update the cache. It does this by fetching a copy of the manifest and, if the manifest has changed since the user agent last saw it, redownloading all the resources it mentions and caching them @@ -42532,7 +42532,7 @@ <td> The user agent will try fetching the files again momentarily. </table><div class="impl"> - <h4 id="appcache"><span class="secno">5.9.2 </span>Application caches</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="appcache"><span class="secno">5.8.2 </span>Application caches</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>An <dfn id="application-cache">application cache</dfn> is a set of cached resources consisting of:</p> @@ -42694,7 +42694,7 @@ </div> - </div><h4 id="manifests"><span class="secno">5.9.3 </span>The cache manifest syntax</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h5 id="a-sample-manifest"><span class="secno">5.9.3.1 </span>A sample manifest</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>This example manifest requires two images and a style sheet to be + </div><h4 id="manifests"><span class="secno">5.8.3 </span>The cache manifest syntax</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h5 id="a-sample-manifest"><span class="secno">5.8.3.1 </span>A sample manifest</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>This example manifest requires two images and a style sheet to be cached and whitelists a CGI script.<pre>CACHE MANIFEST # the above line is required @@ -42743,7 +42743,7 @@ FALLBACK: / /offline.html NETWORK: -*</pre><h5 id="writing-cache-manifests"><span class="secno">5.9.3.2 </span>Writing cache manifests</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Manifests must be served using the +*</pre><h5 id="writing-cache-manifests"><span class="secno">5.8.3.2 </span>Writing cache manifests</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Manifests must be served using the <code><a href="#text-cache-manifest">text/cache-manifest</a></code> <a href="#mime-type">MIME type</a>. All resources served using the <code><a href="#text-cache-manifest">text/cache-manifest</a></code> <a href="#mime-type">MIME type</a> must follow the syntax of application cache @@ -42870,7 +42870,7 @@ namespaces</a> and namespaces in the <a href="#concept-appcache-onlinewhitelist" title="concept-appcache-onlinewhitelist">online whitelist</a> are matched by <a href="#prefix-match">prefix match</a>.<div class="impl"> - <h5 id="parsing-cache-manifests"><span class="secno">5.9.3.3 </span>Parsing cache manifests</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="parsing-cache-manifests"><span class="secno">5.8.3.3 </span>Parsing cache manifests</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When a user agent is to <dfn id="parse-a-manifest">parse a manifest</dfn>, it means that the user agent must run the following steps:</p> @@ -43140,7 +43140,7 @@ </div> - <h4 id="downloading-or-updating-an-application-cache"><span class="secno">5.9.4 </span>Downloading or updating an application cache</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="downloading-or-updating-an-application-cache"><span class="secno">5.8.4 </span>Downloading or updating an application cache</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When the user agent is required (by other parts of this specification) to start the <dfn id="application-cache-download-process">application cache download @@ -43876,7 +43876,7 @@ - <h4 id="the-application-cache-selection-algorithm"><span class="secno">5.9.5 </span>The application cache selection algorithm</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="the-application-cache-selection-algorithm"><span class="secno">5.8.5 </span>The application cache selection algorithm</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When the <dfn id="concept-appcache-init" title="concept-appcache-init">application cache selection algorithm</dfn> algorithm is invoked with a @@ -43963,7 +43963,7 @@ </dd> - </dl><h4 id="changesToNetworkingModel"><span class="secno">5.9.6 </span>Changes to the networking model</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + </dl><h4 id="changesToNetworkingModel"><span class="secno">5.8.6 </span>Changes to the networking model</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When a <a href="#cache-host">cache host</a> is associated with an <a href="#application-cache">application cache</a> whose <a href="#concept-appcache-completeness" title="concept-appcache-completeness">completeness flag</a> is @@ -44027,7 +44027,7 @@ primed the first time), making the testing of offline applications simpler.</p> - </div><h4 id="expiring-application-caches"><span class="secno">5.9.7 </span>Expiring application caches</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>As a general rule, user agents should not expire application + </div><h4 id="expiring-application-caches"><span class="secno">5.8.7 </span>Expiring application caches</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>As a general rule, user agents should not expire application caches, except on request from the user, or after having been left unused for an extended period of time.<p>Application caches and cookies have similar implications with respect to privacy (e.g. if the site can identify the user when @@ -44038,7 +44038,7 @@ origin-specific data.<p class="example">For example, a user agent could have a "delete site-specific data" feature that clears all cookies, application caches, local storage, databases, etc, from an origin all at - once.<h4 id="application-cache-api"><span class="secno">5.9.8 </span>Application cache API</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">interface <dfn id="applicationcache">ApplicationCache</dfn> { + once.<h4 id="application-cache-api"><span class="secno">5.8.8 </span>Application cache API</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">interface <dfn id="applicationcache">ApplicationCache</dfn> { // <a href="#concept-appcache-status" title="concept-appcache-status">update status</a> const unsigned short <a href="#dom-appcache-uncached" title="dom-appcache-UNCACHED">UNCACHED</a> = 0; @@ -44248,7 +44248,7 @@ <tr><td><dfn id="handler-appcache-onupdateready" title="handler-appcache-onupdateready"><code>onupdateready</code></dfn> <td> <code title="event-appcache-updateready"><a href="#event-appcache-updateready">updateready</a></code> <tr><td><dfn id="handler-appcache-oncached" title="handler-appcache-oncached"><code>oncached</code></dfn> <td> <code title="event-appcache-cached"><a href="#event-appcache-cached">cached</a></code> <tr><td><dfn id="handler-appcache-onobsolete" title="handler-appcache-onobsolete"><code>onobsolete</code></dfn> <td> <code title="event-appcache-obsolete"><a href="#event-appcache-obsolete">obsolete</a></code> - </table></div><h4 id="browser-state"><span class="secno">5.9.9 </span>Browser state</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-onLine"><a href="#dom-navigator-online">onLine</a></code></dt> + </table></div><h4 id="browser-state"><span class="secno">5.8.9 </span>Browser state</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-onLine"><a href="#dom-navigator-online">onLine</a></code></dt> <dd> @@ -44283,7 +44283,7 @@ source</a>.</p> </div><p class="note">This attribute is inherently unreliable. A computer - can be connected to a network without having Internet access.<h3 id="history"><span class="secno">5.10 </span>Session history and navigation</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h4 id="the-session-history-of-browsing-contexts"><span class="secno">5.10.1 </span>The session history of browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The sequence of <code>Document</code>s in a <a href="#browsing-context">browsing + can be connected to a network without having Internet access.<h3 id="history"><span class="secno">5.9 </span>Session history and navigation</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h4 id="the-session-history-of-browsing-contexts"><span class="secno">5.9.1 </span>The session history of browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The sequence of <code>Document</code>s in a <a href="#browsing-context">browsing context</a> is its <dfn id="session-history">session history</dfn>.<p><code><a href="#history-0">History</a></code> objects provide a representation of the pages in the session history of <a href="#browsing-context" title="browsing context">browsing contexts</a>. Each <a href="#browsing-context">browsing @@ -44349,7 +44349,7 @@ entries that shared the same <code>Document</code> object with it must share the new object as well.</p> - </div><h4 id="the-history-interface"><span class="secno">5.10.2 </span>The <code><a href="#history-0">History</a></code> interface</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">interface <dfn id="history-0">History</dfn> { + </div><h4 id="the-history-interface"><span class="secno">5.9.2 </span>The <code><a href="#history-0">History</a></code> interface</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">interface <dfn id="history-0">History</dfn> { readonly attribute long <a href="#dom-history-length" title="dom-history-length">length</a>; void <a href="#dom-history-go" title="dom-history-go">go</a>(in optional long delta); void <a href="#dom-history-back" title="dom-history-back">back</a>(); @@ -44687,7 +44687,7 @@ State: <OUTPUT NAME=I>1</OUTPUT> <INPUT VALUE="Increment" TYPE=BUTTON ONCLICK="inc()"> </FORM></pre> - </div><h4 id="the-location-interface"><span class="secno">5.10.3 </span>The <code><a href="#location">Location</a></code> interface</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Each <code>Document</code> object in a <a href="#browsing-context">browsing + </div><h4 id="the-location-interface"><span class="secno">5.9.3 </span>The <code><a href="#location">Location</a></code> interface</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Each <code>Document</code> object in a <a href="#browsing-context">browsing context</a>'s session history is associated with a unique instance of a <code><a href="#location">Location</a></code> object.<dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-location"><a href="#dom-document-location">location</a></code> [ = <var title="">value</var> ]</dt> <dt><var title="">window</var> . <code title="dom-location"><a href="#dom-location">location</a></code> [ = <var title="">value</var> ]</dt> @@ -44878,7 +44878,7 @@ </div><div class="impl"> - <h5 id="security-3"><span class="secno">5.10.3.1 </span>Security</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="security-3"><span class="secno">5.9.3.1 </span>Security</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>User agents must raise a <code><a href="#security_err">SECURITY_ERR</a></code> exception whenever any of the members of a <code><a href="#location">Location</a></code> object are accessed by @@ -44898,7 +44898,7 @@ </ul></div><div class="impl"> - <h4 id="history-notes"><span class="secno">5.10.4 </span>Implementation notes for session history</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="history-notes"><span class="secno">5.9.4 </span>Implementation notes for session history</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <!-- don't change the ID without updating multiple internal links --> <p><i>This section is non-normative.</i></p> @@ -44934,9 +44934,9 @@ a timer, or from event listeners that are not triggered in response to a clear user action, or that are invoked in rapid succession.</p> - </div><h3 id="browsing-the-web"><span class="secno">5.11 </span>Browsing the Web</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> + </div><h3 id="browsing-the-web"><span class="secno">5.10 </span>Browsing the Web</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> - <h4 id="navigating-across-documents"><span class="secno">5.11.1 </span>Navigating across documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="navigating-across-documents"><span class="secno">5.10.1 </span>Navigating across documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>Certain actions cause the <a href="#browsing-context">browsing context</a> to <i><a href="#navigate">navigate</a></i> to a new resource. Navigation always involves @@ -45377,7 +45377,7 @@ source</a>.</p> - <h4 id="read-html"><span class="secno">5.11.2 </span><dfn title="navigate-html">Page load processing model for HTML files</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="read-html"><span class="secno">5.10.2 </span><dfn title="navigate-html">Page load processing model for HTML files</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When an HTML document is to be loaded in a <a href="#browsing-context">browsing context</a>, the user agent must <a href="#create-a-document-object">create a @@ -45410,7 +45410,7 @@ - <h4 id="read-xml"><span class="secno">5.11.3 </span><dfn title="navigate-xml">Page load processing model for XML files</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="read-xml"><span class="secno">5.10.3 </span><dfn title="navigate-xml">Page load processing model for XML files</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When faced with displaying an XML file inline, user agents must first <a href="#create-a-document-object">create a <code>Document</code> object</a>, following @@ -45466,7 +45466,7 @@ <code>Document</code>.</p> - <h4 id="read-text"><span class="secno">5.11.4 </span><dfn title="navigate-text">Page load processing model for text files</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i></p> + <h4 id="read-text"><span class="secno">5.10.4 </span><dfn title="navigate-text">Page load processing model for text files</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i></p> <p>When a plain text document is to be loaded in a <a href="#browsing-context">browsing context</a>, the user agent should <a href="#create-a-document-object">create a @@ -45509,7 +45509,7 @@ etc.</p> - <h4 id="read-image"><span class="secno">5.11.5 </span><dfn title="navigate-image">Page load processing model for images</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="read-image"><span class="secno">5.10.5 </span><dfn title="navigate-image">Page load processing model for images</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When an image resource is to be loaded in a <a href="#browsing-context">browsing context</a>, the user agent should <a href="#create-a-document-object">create a @@ -45541,7 +45541,7 @@ a script, to give the document a <code><a href="#the-title-element-0">title</a></code>, etc.</p> - <h4 id="read-plugin"><span class="secno">5.11.6 </span><dfn title="navigate-plugin">Page load processing model for content that uses plugins</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="read-plugin"><span class="secno">5.10.6 </span><dfn title="navigate-plugin">Page load processing model for content that uses plugins</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When a resource that requires an external resource to be rendered is to be loaded in a <a href="#browsing-context">browsing context</a>, the user agent @@ -45579,7 +45579,7 @@ synthesized <code><a href="#the-embed-element">embed</a></code> element will <a href="#sandboxPluginEmbed">fail to render the content</a>.</p> - <h4 id="read-ua-inline"><span class="secno">5.11.7 </span><dfn title="navigate-ua-inline">Page load processing model for inline content that doesn't have a DOM</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="read-ua-inline"><span class="secno">5.10.7 </span><dfn title="navigate-ua-inline">Page load processing model for inline content that doesn't have a DOM</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When the user agent is to display a user agent page inline in a <a href="#browsing-context">browsing context</a>, the user agent should <a href="#create-a-document-object">create a @@ -45606,7 +45606,7 @@ - <h4 id="scroll-to-fragid"><span class="secno">5.11.8 </span><dfn title="navigate-fragid">Navigating to a fragment identifier</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="scroll-to-fragid"><span class="secno">5.10.8 </span><dfn title="navigate-fragid">Navigating to a fragment identifier</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>When a user agent is supposed to navigate to a fragment identifier, then the user agent must <a href="#queue-a-task">queue a task</a> to @@ -45697,7 +45697,7 @@ document</a>, if that is an element; otherwise there is no <i><a href="#target-element">target element</a></i>. <a href="#refsSELECTORS">[SELECTORS]</a></p> - </div><h4 id="history-traversal"><span class="secno">5.11.9 </span>History traversal</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- session history --><div class="impl"> + </div><h4 id="history-traversal"><span class="secno">5.10.9 </span>History traversal</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- session history --><div class="impl"> <p>When a user agent is required to <dfn id="traverse-the-history">traverse the history</dfn> to a <i>specified entry</i>, optionally with <a href="#replacement-enabled">replacement @@ -45867,7 +45867,7 @@ <a href="#dom-manipulation-task-source">DOM manipulation task source</a>.</p> - <h5 id="event-definitions"><span class="secno">5.11.9.1 </span>Event definitions</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="event-definitions"><span class="secno">5.10.9.1 </span>Event definitions</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> </div><p>The <dfn id="event-popstate" title="event-popstate"><code>popstate</code></dfn> event is fired when navigating to a <a href="#session-history-entry">session history entry</a> @@ -45935,7 +45935,7 @@ the URL of the <a href="#session-history-entry">session history entry</a> that was traversed to.</p> - </div><h4 id="unloading-documents"><span class="secno">5.11.10 </span>Unloading documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> + </div><h4 id="unloading-documents"><span class="secno">5.10.10 </span>Unloading documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><div class="impl"> <p>A <code>Document</code> has a <var title="">salvageable</var> state, which is initially true.</p> @@ -46075,7 +46075,7 @@ <code>Document</code>'s <a href="#browsing-context">browsing context</a> must <a href="#discard-a-document" title="discard a document">discard the <code>Document</code></a>.</li> - </ol><h5 id="event-definition"><span class="secno">5.11.10.1 </span>Event definition</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + </ol><h5 id="event-definition"><span class="secno">5.10.10.1 </span>Event definition</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> </div><pre class="idl">interface <dfn id="beforeunloadevent">BeforeUnloadEvent</dfn> : Event { attribute DOMString <a href="#dom-beforeunloadevent-returnvalue" title="dom-BeforeUnloadEvent-returnValue">returnValue</a>; @@ -46100,7 +46100,7 @@ </div><div class="impl"> - <h4 id="aborting-a-document-load"><span class="secno">5.11.11 </span>Aborting a document load</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h4 id="aborting-a-document-load"><span class="secno">5.10.11 </span>Aborting a document load</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <p>If the user cancels any instance of the <a href="#fetch" title="fetch">fetching algorithm</a> in the context of a <code>Document</code> in a <a href="#browsing-context">browsing context</a>, then, if
Received on Friday, 5 February 2010 23:26:01 UTC