- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 21 Nov 2009 15:03:31 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec-author-view
In directory hutz:/tmp/cvs-serv26725
Modified Files:
browsers.html dom.html editing.html history.html
infrastructure.html interactive-elements.html semantics.html
spec.html the-canvas-element.html video.html
Log Message:
Nuke history.clearState() since it was confusingly specced and its use cases were unclear. (whatwg r4375)
[updated by splitter]
Index: infrastructure.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/infrastructure.html,v
retrieving revision 1.501
retrieving revision 1.502
diff -u -d -r1.501 -r1.502
--- infrastructure.html 21 Nov 2009 14:47:41 -0000 1.501
+++ infrastructure.html 21 Nov 2009 15:03:28 -0000 1.502
@@ -0,0 +1,1223 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!DOCTYPE html>
+<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><head><title>2 Common infrastructure — HTML 5</title><style type="text/css">
+ pre { margin-left: 2em; white-space: pre-wrap; }
+ h2 { margin: 3em 0 1em 0; }
+ h3 { margin: 2.5em 0 1em 0; }
+ h4 { margin: 2.5em 0 0.75em 0; }
+ h5, h6 { margin: 2.5em 0 1em; }
+ h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; }
+ h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; }
+ p { margin: 1em 0; }
[...1193 lines suppressed...]
+ <li value="8"><dfn id="not_found_err"><code>NOT_FOUND_ERR</code></dfn></li>
+ <li value="9"><dfn id="not_supported_err"><code>NOT_SUPPORTED_ERR</code></dfn></li>
+ <li value="10"><dfn id="inuse_attribute_err"><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
+ <li value="11"><dfn id="invalid_state_err"><code>INVALID_STATE_ERR</code></dfn></li>
+ <li value="12"><dfn id="syntax_err"><code>SYNTAX_ERR</code></dfn></li>
+ <li value="13"><dfn id="invalid_modification_err"><code>INVALID_MODIFICATION_ERR</code></dfn></li>
+ <li value="14"><dfn id="namespace_err"><code>NAMESPACE_ERR</code></dfn></li>
+ <li value="15"><dfn id="invalid_access_err"><code>INVALID_ACCESS_ERR</code></dfn></li>
+ <li value="16"><dfn id="validation_err"><code>VALIDATION_ERR</code></dfn></li>
+ <li value="17"><dfn id="type_mismatch_err"><code>TYPE_MISMATCH_ERR</code></dfn></li>
+ <li value="18"><dfn id="security_err"><code>SECURITY_ERR</code></dfn></li> <!-- actually in XHR for now -->
+ <li value="19"><dfn id="network_err"><code>NETWORK_ERR</code></dfn></li> <!-- actually in XHR for now -->
+ <li value="20"><dfn id="abort_err"><code>ABORT_ERR</code></dfn></li> <!-- actually in XHR for now -->
+ <li value="21"><dfn id="url_mismatch_err"><code>URL_MISMATCH_ERR</code></dfn></li> <!-- actually in workers for now -->
+ <li value="22"><dfn id="quota_exceeded_err"><code>QUOTA_EXCEEDED_ERR</code></dfn></li> <!-- actually defined right here for now -->
+<!--v2DATAGRID <li value="23"><dfn><code>DATAGRID_MODEL_ERR</code></dfn></li> --> <!-- actually defined right here for now -->
+ <li value="81"><dfn id="parse_err"><code>PARSE_ERR</code></dfn></li> <!-- actually defined in dom3ls -->
+ <li value="82"><dfn id="serialize_err"><code>SERIALIZE_ERR</code></dfn></li> <!-- actually defined in dom3ls -->
+ </ol></body></html>
\ No newline at end of file
Index: history.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/history.html,v
retrieving revision 1.501
retrieving revision 1.502
diff -u -d -r1.501 -r1.502
--- history.html 21 Nov 2009 14:47:41 -0000 1.501
+++ history.html 21 Nov 2009 15:03:28 -0000 1.502
@@ -0,0 +1,1136 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!DOCTYPE html>
+<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><head><title>6.8 Session history and navigation — HTML 5</title><style type="text/css">
+ pre { margin-left: 2em; white-space: pre-wrap; }
+ h2 { margin: 3em 0 1em 0; }
+ h3 { margin: 2.5em 0 1em 0; }
+ h4 { margin: 2.5em 0 0.75em 0; }
+ h5, h6 { margin: 2.5em 0 1em; }
+ h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; }
+ h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; }
+ p { margin: 1em 0; }
[...1106 lines suppressed...]
+ period of a month or more without being used or specified, then it
+ may be removed from the registry.</p>
+
+ <p>If a keyword is added with the "proposed" status and found to
+ be redundant with existing values, it should be removed and listed
+ as a synonym for the existing value. If a keyword is added with
+ the "proposed" status and found to be harmful, then it should be
+ changed to "discontinued" status.</p>
+
+ <p>Anyone can change the status at any time, but should only do so
+ in accordance with the definitions above.</p>
+
+ </dd>
+
+ </dl><p>Types defined as extensions in the <a href="http://wiki.whatwg.org/wiki/RelExtensions">WHATWG Wiki
+ RelExtensions page</a> with the status "proposed" or "ratified" may
+ be used with the <code title="">rel</code> attribute on
+ <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-canvas-element.html#the-area-element">area</a></code> elements in
+ accordance to the "Effect on..." field. <a href="references.html#refsWHATWGWIKI">[WHATWGWIKI]</a></p></body></html>
\ No newline at end of file
Index: dom.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/dom.html,v
retrieving revision 1.503
retrieving revision 1.504
diff -u -d -r1.503 -r1.504
--- dom.html 21 Nov 2009 14:47:41 -0000 1.503
+++ dom.html 21 Nov 2009 15:03:27 -0000 1.504
@@ -1371,4 +1371,32 @@
<li><code><a href="text-level-semantics.html#the-progress-element">progress</a></code></li>
<li><code><a href="text-level-semantics.html#the-q-element">q</a></code></li>
<li><code><a href="text-level-semantics.html#the-ruby-element">ruby</a></code></li>
- <li><code><a href="text-level-semantics.html#
\ No newline at end of file
+ <li><code><a href="text-level-semantics.html#the-samp-element">samp</a></code></li>
+ <li><code><a href="semantics.html#script">script</a></code></li>
+ <li><code><a href="forms.html#the-select-element">select</a></code></li>
+ <li><code><a href="text-level-semantics.html#the-small-element">small</a></code></li>
+ <li><code><a href="text-level-semantics.html#the-span-element">span</a></code></li>
+ <li><code><a href="text-level-semantics.html#the-strong-element">strong</a></code></li>
+ <li><code><a href="text-level-semantics.html#the-sub-and-sup-elements">sub</a></code></li>
+ <li><code><a href="text-level-semantics.html#the-sub-and-sup-elements">sup</a></code></li>
+ <li><code><a href="the-canvas-element.html#svg">svg</a></code></li>
+ <li><code><a href="forms.html#the-textarea-element">textarea</a></code></li>
+ <li><code><a href="text-level-semantics.html#the-time-element">time</a></code></li>
+ <li><code><a href="text-level-semantics.html#the-var-element">var</a></code></li>
+ <li><code><a href="video.html#video">video</a></code></li>
+ <li><a href="#text-content" title="text content">Text</a></li>
+ </ul><p>As a general rule, elements whose content model allows any
+ <a href="#phrasing-content">phrasing content</a> should have either at least one
+ descendant <a href="infrastructure.html#text-node">text node</a> that is not <a href="#inter-element-whitespace">inter-element
+ whitespace</a>, or at least one descendant element node that is
+ <a href="embedded-content-0.html#embedded-content">embedded content</a>. For the purposes of this requirement,
+ nodes that are descendants of <code><a href="text-level-semantics.html#the-del-element">del</a></code> elements must not be
+ counted as contributing to the ancestors of the <code><a href="text-level-semantics.html#the-del-element">del</a></code>
+ element.</p><p class="note">Most elements that are categorized as phrasing
+ content can only contain elements that are themselves categorized as
+ phrasing content, not any flow content.</p><p><dfn id="text-content" title="text content">Text</dfn>, in the context of content
+ models, means <a href="infrastructure.html#text-node" title="text node">text nodes</a>. <a href="#text-content" title="text content">Text</a> is sometimes used as a content
+ model on its own, but is also <a href="#phrasing-content">phrasing content</a>, and can
+ be <a href="#inter-element-whitespace">inter-element whitespace</a> (if the <a href="infrastructure.html#text-node" title="text
+ node">text nodes</a> are empty or contain just <a href="#space-character" title="space
+ character">space characters</a>).</p></body></html>
\ No newline at end of file
Index: the-canvas-element.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/the-canvas-element.html,v
retrieving revision 1.502
retrieving revision 1.503
diff -u -d -r1.502 -r1.503
--- the-canvas-element.html 21 Nov 2009 14:47:42 -0000 1.502
+++ the-canvas-element.html 21 Nov 2009 15:03:28 -0000 1.503
@@ -0,0 +1,1588 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!DOCTYPE html>
+<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><head><title>4.8.11 The canvas element — HTML 5</title><style type="text/css">
+ pre { margin-left: 2em; white-space: pre-wrap; }
+ h2 { margin: 3em 0 1em 0; }
+ h3 { margin: 2.5em 0 1em 0; }
+ h4 { margin: 2.5em 0 0.75em 0; }
+ h5, h6 { margin: 2.5em 0 1em; }
+ h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; }
+ h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; }
+ p { margin: 1em 0; }
[...1558 lines suppressed...]
+ CSS pixels have a resolution of 96ppi, but in general the CSS pixel
+ resolution depends on the reading distance.) If both attributes are
+ specified, then one of the following statements must be true:</p><ul><li><span title=""><var title="">specified width</var> - 0.5 ≤
+ <var title="">specified height</var> * <var title="">target ratio</var> ≤
+ <var title="">specified width</var> + 0.5</span></li>
+
+ <li><span title=""><var title="">specified height</var> - 0.5 ≤
+ <var title="">specified width</var> / <var title="">target ratio</var> ≤
+ <var title="">specified height</var> + 0.5</span></li>
+
+ <li><span title=""><var title="">specified height</var> = <var title="">specified width</var> = 0</span></li>
+
+ </ul><p>The <var title="">target ratio</var> is the ratio of the
+ intrinsic width to the intrinsic height in the resource. The <var title="">specified width</var> and <var title="">specified
+ height</var> are the values of the <code title="attr-dim-width"><a href="#attr-dim-width">width</a></code> and <code title="attr-dim-height"><a href="#attr-dim-height">height</a></code> attributes respectively.</p><p>The two attributes must be omitted if the resource in question
+ does not have both an intrinsic width and an intrinsic height.</p><p>If the two attributes are both zero, it indicates that the
+ element is not intended for the user (e.g. it might be a part of a
+ service to count page views).</p><p class="note">The dimension attributes are not intended to be used
+ to stretch the image.</p></body></html>
\ No newline at end of file
Index: interactive-elements.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/interactive-elements.html,v
retrieving revision 1.500
retrieving revision 1.501
diff -u -d -r1.500 -r1.501
--- interactive-elements.html 21 Nov 2009 14:47:41 -0000 1.500
+++ interactive-elements.html 21 Nov 2009 15:03:28 -0000 1.501
@@ -0,0 +1,3445 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!DOCTYPE html>
+<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><head><title>4.11 Interactive elements — HTML 5</title><style type="text/css">
+ pre { margin-left: 2em; white-space: pre-wrap; }
+ h2 { margin: 3em 0 1em 0; }
+ h3 { margin: 2.5em 0 1em 0; }
+ h4 { margin: 2.5em 0 0.75em 0; }
+ h5, h6 { margin: 2.5em 0 1em; }
+ h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; }
+ h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; }
+ p { margin: 1em 0; }
[...3415 lines suppressed...]
+ <td> Wherever possible
+ <td> £0<sup><a href="#fn1">1</a></sup>
+ <tr>
+ <td> Routines, chorus scenes<sup><a href="#fn2">2</a></sup>
+ <td> Undisclosed
+ <td> Undisclosed
+ <tr>
+ <td> Dining<sup><a href="#fn3">3</a></sup>
+ <td> Camelot
+ <td> Cost of ham, jam, and spam<sup><a href="#fn4">4</a></sup>
+ </table>
+ <p id="fn1">1. Assumed.</p>
+ <p id="fn2">2. Footwork impeccable.</p>
+ <p id="fn3">3. Quality described as "well".</p>
+ <p id="fn4">4. A lot.</p>
+ </dd>
+</figure></pre>
+
+ </div></body></html>
\ No newline at end of file
Index: editing.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/editing.html,v
retrieving revision 1.502
retrieving revision 1.503
diff -u -d -r1.502 -r1.503
--- editing.html 21 Nov 2009 14:47:41 -0000 1.502
+++ editing.html 21 Nov 2009 15:03:28 -0000 1.503
@@ -0,0 +1,1458 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!DOCTYPE html>
+<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><head><title>7 User Interaction — HTML 5</title><style type="text/css">
+ pre { margin-left: 2em; white-space: pre-wrap; }
+ h2 { margin: 3em 0 1em 0; }
+ h3 { margin: 2.5em 0 1em 0; }
+ h4 { margin: 2.5em 0 0.75em 0; }
+ h5, h6 { margin: 2.5em 0 1em; }
+ h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; }
+ h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; }
+ p { margin: 1em 0; }
[...1428 lines suppressed...]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </dl><!--
+v2 (well, really v0):
+ "forecolor", "hilitecolor", "fontname", "fontsize", "justifyleft",
+ "justifycenter", "justifyright", "justifyfull", "indent", "outdent"
+--></body></html>
\ No newline at end of file
Index: video.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/video.html,v
retrieving revision 1.502
retrieving revision 1.503
diff -u -d -r1.502 -r1.503
--- video.html 21 Nov 2009 14:47:42 -0000 1.502
+++ video.html 21 Nov 2009 15:03:28 -0000 1.503
@@ -0,0 +1,1288 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!DOCTYPE html>
+<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><head><title>4.8.7 The video element — HTML 5</title><style type="text/css">
+ pre { margin-left: 2em; white-space: pre-wrap; }
+ h2 { margin: 3em 0 1em 0; }
+ h3 { margin: 2.5em 0 1em 0; }
+ h4 { margin: 2.5em 0 0.75em 0; }
+ h5, h6 { margin: 2.5em 0 1em; }
+ h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; }
+ h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; }
+ p { margin: 1em 0; }
[...1258 lines suppressed...]
+ </td><td>
+ </td></tr><tr><td><dfn id="event-media-ended" title="event-media-ended"><code>ended</code></dfn>
+ </td><td><code>Event</code>
+ </td><td>Playback has stopped because the end of the <a href="#media-resource">media resource</a> was reached.
+ </td><td><code title="dom-media-currentTime"><a href="#dom-media-currenttime">currentTime</a></code> equals the end of the <a href="#media-resource">media resource</a>; <code title="dom-media-ended"><a href="#dom-media-ended">ended</a></code> is true.
+
+ </td></tr></tbody><tbody><tr><td><dfn id="event-media-ratechange" title="event-media-ratechange"><code>ratechange</code></dfn>
+ </td><td><code>Event</code>
+ </td><td>Either the <code title="dom-media-defaultPlaybackRate"><a href="#dom-media-defaultplaybackrate">defaultPlaybackRate</a></code> or the <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code> attribute has just been updated.
+ </td><td>
+ </td></tr><tr><td><dfn id="event-media-durationchange" title="event-media-durationchange"><code>durationchange</code></dfn>
+ </td><td><code>Event</code>
+ </td><td>The <code title="dom-media-duration"><a href="#dom-media-duration">duration</a></code> attribute has just been updated.
+ </td><td>
+ </td></tr><tr><td><dfn id="event-media-volumechange" title="event-media-volumechange"><code>volumechange</code></dfn>
+ </td><td><code>Event</code>
+ </td><td>Either the <code title="dom-media-volume"><a href="#dom-media-volume">volume</a></code> attribute or the <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code> attribute has changed. Fired after the relevant attribute's setter has returned.
+ </td><td>
+ </td></tr></tbody></table></body></html>
\ No newline at end of file
Index: browsers.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/browsers.html,v
retrieving revision 1.503
retrieving revision 1.504
diff -u -d -r1.503 -r1.504
--- browsers.html 21 Nov 2009 14:47:41 -0000 1.503
+++ browsers.html 21 Nov 2009 15:03:27 -0000 1.504
@@ -212,4 +212,685 @@
.apple-table-examples.e2 th[scope=row] { padding-left: 1em; }
.apple-table-examples sup { line-height: 0; }
- </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation req
\ No newline at end of file
+ </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="http://www.w3.org/StyleSheets/TR/W3C-ED" rel="stylesheet" type="text/css"><link href="microdata.html" title="5 Microdata" rel="prev">
+ <link href="Overview.html#contents" title="Table of contents" rel="index">
+ <link href="offline.html" title="6.7 Offline Web applications" rel="next">
+ </head><body onload="fixBrokenLink(); fixBrokenLink()"><div class="head">
+ <p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"></a></p>
+ <h1>HTML5</h1>
+ <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
+<p>This is revision 1.3508.</p>
+
+ </div><div>
+ <a href="microdata.html">← 5 Microdata</a> –
+ <a href="Overview.html#contents">Table of contents</a> –
+ <a href="offline.html">6.7 Offline Web applications →</a>
+ </div>
+
+ <h2 id="browsers"><span class="secno">6 </span>Web browsers</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><h3 id="windows"><span class="secno">6.1 </span>Browsing contexts</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="browsing-context">browsing context</dfn> is an environment in which
+ <code>Document</code> objects are presented to the user.</p><p class="note">A tab or window in a Web browser typically contains
+ a <a href="#browsing-context">browsing context</a>, as does an <code><a href="text-level-semantics.html#the-iframe-element">iframe</a></code>.</p><p>Each <a href="#browsing-context">browsing context</a> has a corresponding
+ <code><a href="#windowproxy">WindowProxy</a></code> object.</p><p>A <a href="#browsing-context">browsing context</a> has a <a href="history.html#session-history">session
+ history</a>, which lists the <code>Document</code> objects that
+ that <a href="#browsing-context">browsing context</a> has presented, is presenting, or
+ will present. At any time, one <code>Document</code> in each
+ <a href="#browsing-context">browsing context</a> is designated the <dfn id="active-document">active
+ document</dfn>.</p><p>Each <code>Document</code> has a collection of one or more <a href="#view" title="view">views</a>.</p><p>A <dfn id="view">view</dfn> is a user agent interface tied to a particular
+ media used for the presentation of a particular
+ <code>Document</code> object in some media. A view may be
+ interactive. Each view is represented by an
+ <code>AbstractView</code> object. <a href="references.html#refsDOMVIEWS">[DOMVIEWS]</a></p><p>The main <a href="#view">view</a> through which a user primarily
+ interacts with a user agent is the <dfn id="default-view">default view</dfn>. The
+ <code>AbstractView</code> object that represents this view is referred to as the <code>Document</code>'s
+ <code><a href="#window">Window</a></code> object. <code><a href="#windowproxy">WindowProxy</a></code> objects forward
+ everything to the <a href="#active-document">active document</a>'s <a href="#default-view">default
+ view</a>'s <code><a href="#window">Window</a></code> object.</p><p class="note">The <code title="dom-document">document</code>
+ attribute of an <code>AbstractView</code> object representing a
+ <a href="#view">view</a> gives the view's corresponding
+ <code>Document</code> object. <a href="references.html#refsDOMVIEWS">[DOMVIEWS]</a></p><p class="note">In general, there is a 1-to-1 mapping from the
+ <code><a href="#window">Window</a></code> object to the <code>Document</code> object. In
+ one particular case, a set of <a href="#view" title="view">views</a> can be
+ reused for the presentation of a second <code>Document</code> in the
+ same <a href="#browsing-context">browsing context</a>, such that the mapping is then
+ 2:1. This occurs when a <a href="#browsing-context">browsing context</a> is <a href="#navigate" title="navigate">navigated</a> from the initial
+ <code><a href="#about:blank">about:blank</a></code> <code>Document</code> to another, with
+ <a href="#replacement-enabled">replacement enabled</a>.</p><p class="note">A typical Web browser has one obvious
+ <a href="#view">view</a> per <code>Document</code>: the browser's window
+ (screen media). This is typically the <a href="#default-view">default view</a>. If
+ a page is printed, however, a second view becomes evident, that of
+ the print media. The two views always share the same underlying
+ <code>Document</code> object, but they have a different presentation
+ of that object. A speech browser might have a different
+ <a href="#default-view">default view</a>, using the speech media.</p><p class="note">A <code>Document</code> does not necessarily have a
+ <a href="#browsing-context">browsing context</a> associated with it. In particular,
+ data mining tools are likely to never instantiate browsing
+ contexts.</p><hr><p>A <a href="#browsing-context">browsing context</a> can have a <dfn id="creator-browsing-context">creator browsing
+ context</dfn>, the <a href="#browsing-context">browsing context</a> that was
+ responsible for its creation. </p><p>If a <a href="#browsing-context">browsing context</a> <var title="">A</var> has a
+ <a href="#creator-browsing-context">creator browsing context</a>, then the
+ <code>Document</code> that was the <a href="#active-document">active document</a> of
+ that <a href="#creator-browsing-context">creator browsing context</a> at the time <var title="">A</var> was created is the <dfn id="creator-document">creator
+ <code>Document</code></dfn>.</p><h4 id="nested-browsing-contexts"><span class="secno">6.1.1 </span>Nested browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Certain elements (for example, <code><a href="text-level-semantics.html#the-iframe-element">iframe</a></code> elements) can
+ instantiate further <a href="#browsing-context" title="browsing context">browsing
+ contexts</a>. These are called <dfn id="nested-browsing-context" title="nested browsing
+ context">nested browsing contexts</dfn>. If a browsing context <var title="">P</var> has an element <var title="">E</var> in one of its
+ <code>Document</code>s <var title="">D</var> that nests another
+ browsing context <var title="">C</var> inside it, then <var title="">P</var> is said to be the <dfn id="parent-browsing-context">parent browsing
+ context</dfn> of <var title="">C</var>, <var title="">C</var> is
+ said to be a <dfn id="child-browsing-context">child browsing context</dfn> of <var title="">P</var>, <var title="">C</var> is said to be <dfn id="browsing-context-nested-through" title="browsing context nested through">nested through</dfn> <var title="">D</var>, and <var title="">E</var> is said to be the
+ <dfn id="browsing-context-container">browsing context container</dfn> of <var title="">C</var>.</p><p>A browsing context <var title="">A</var> is said to be an
+ ancestor of a browsing context <var title="">B</var> if there exists
+ a browsing context <var title="">A'</var> that is a <a href="#child-browsing-context">child
+ browsing context</a> of <var title="">A</var> and that is itself
+ an ancestor of <var title="">B</var>, or if there is a browsing
+ context <var title="">P</var> that is a <a href="#child-browsing-context">child browsing
+ context</a> of <var title="">A</var> and that is the <a href="#parent-browsing-context">parent
+ browsing context</a> of <var title="">B</var>.</p><p>The browsing context with no <a href="#parent-browsing-context">parent browsing context</a>
+ is the <dfn id="top-level-browsing-context">top-level browsing context</dfn> of all the browsing
+ contexts <a href="#nested-browsing-context" title="nested browsing context">nested</a> within
+ it (either directly or indirectly through other nested browsing
+ contexts).</p><p>The transitive closure of <a href="#parent-browsing-context" title="parent browsing
+ context">parent browsing contexts</a> for a <a href="#nested-browsing-context">nested browsing
+ context</a> gives the list of <dfn id="ancestor-browsing-context" title="ancestor browsing
+ context">ancestor browsing contexts</dfn>.</p><p>A <code>Document</code> is said to be <dfn id="fully-active">fully active</dfn>
+ when it is the <a href="#active-document">active document</a> of its <a href="#browsing-context">browsing
+ context</a>, and either its browsing context is a <a href="#top-level-browsing-context">top-level
+ browsing context</a>, or the <code>Document</code> <a href="#browsing-context-nested-through" title="browsing context nested through">through which</a> that
+ browsing context is <a href="#nested-browsing-context" title="nested browsing
+ context">nested</a> is itself <a href="#fully-active">fully active</a>.</p><p>Because they are nested through an element, <a href="#child-browsing-context" title="child
+ browsing context">child browsing contexts</a> are always tied to
+ a specific <code>Document</code> in their <a href="#parent-browsing-context">parent browsing
+ context</a>. User agents must not allow the user to interact with
+ <a href="#child-browsing-context" title="child browsing context">child browsing contexts</a>
+ of elements that are in <code>Document</code>s that are not
+ themselves <a href="#fully-active">fully active</a>.</p><p>A <a href="#nested-browsing-context">nested browsing context</a> can have a <a href="#seamless-browsing-context-flag">seamless
+ browsing context flag</a> set, if it is embedded through an
+ <code><a href="text-level-semantics.html#the-iframe-element">iframe</a></code> element with a <code title="attr-iframe-seamless"><a href="text-level-semantics.html#attr-iframe-seamless">seamless</a></code> attribute.</p><h5 id="navigating-nested-browsing-contexts-in-the-dom"><span class="secno">6.1.1.1 </span>Navigating nested browsing contexts in the DOM</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><dl class="domintro"><dt><var title="">window</var> . <code title="dom-top"><a href="#dom-top">top</a></code></dt>
+
+ <dd>
+
+ <p>Returns the <code><a href="#windowproxy">WindowProxy</a></code> for the <a href="#top-level-browsing-context">top-level browsing context</a>.</p>
+
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-parent"><a href="#dom-parent">parent</a></code></dt>
+
+ <dd>
+
+ <p>Returns the <code><a href="#windowproxy">WindowProxy</a></code> for the <a href="#parent-browsing-context">parent browsing context</a>.</p>
+
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-frameElement"><a href="#dom-frameelement">frameElement</a></code></dt>
+
+ <dd>
+
+ <p>Returns the <code>Element</code> for the <a href="#browsing-context-container">browsing context container</a>.</p>
+
+ <p>Returns null if there isn't one.</p>
+
+ <p>Throws a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception in cross-origin situations.</p>
+
+ </dd>
+
+ </dl><h4 id="auxiliary-browsing-contexts"><span class="secno">6.1.2 </span>Auxiliary browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>It is possible to create new browsing contexts that are related
+ to a <a href="#top-level-browsing-context">top-level browsing context</a> without being nested
+ through an element. Such browsing contexts are called <dfn id="auxiliary-browsing-context" title="auxiliary browsing context">auxiliary browsing
+ contexts</dfn>. Auxiliary browsing contexts are always <a href="#top-level-browsing-context" title="top-level browsing context">top-level browsing
+ contexts</a>.</p><p>An <a href="#auxiliary-browsing-context">auxiliary browsing context</a> has an <dfn id="opener-browsing-context">opener
+ browsing context</dfn>, which is the <a href="#browsing-context">browsing context</a>
+ from which the <a href="#auxiliary-browsing-context">auxiliary browsing context</a> was created,
+ and it has a <dfn id="furthest-ancestor-browsing-context">furthest ancestor browsing context</dfn>, which is
+ the <a href="#top-level-browsing-context">top-level browsing context</a> of the <a href="#opener-browsing-context">opener
+ browsing context</a> when the <a href="#auxiliary-browsing-context">auxiliary browsing
+ context</a> was created.</p><h5 id="navigating-auxiliary-browsing-contexts-in-the-dom"><span class="secno">6.1.2.1 </span>Navigating auxiliary browsing contexts in the DOM</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <dfn id="dom-opener" title="dom-opener"><code>opener</code></dfn> IDL
+ attribute on the <code><a href="#window">Window</a></code> object must return the
+ <code><a href="#windowproxy">WindowProxy</a></code> object of the <a href="#browsing-context">browsing context</a>
+ from which the current <a href="#browsing-context">browsing context</a> was created
+ (its <a href="#opener-browsing-context">opener browsing context</a>), if there is one and it
+ is still available.</p><h4 id="secondary-browsing-contexts"><span class="secno">6.1.3 </span>Secondary browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>User agents may support <dfn id="secondary-browsing-context" title="secondary browsing
+ context">secondary browsing contexts</dfn>, which are <a href="#browsing-context" title="browsing context">browsing contexts</a> that form part of
+ the user agent's interface, apart from the main content area.</p><h4 id="browsing-context-names"><span class="secno">6.1.4 </span>Browsing context names</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Browsing contexts can have a <dfn id="browsing-context-name">browsing context name</dfn>. By
+ default, a browsing context has no name (its name is not set).</p><p>A <dfn id="valid-browsing-context-name">valid browsing context name</dfn> is any string with at
+ least one character that does not start with a U+005F LOW LINE
+ character. (Names starting with an underscore are reserved for
+ special keywords.)</p><p>A <dfn id="valid-browsing-context-name-or-keyword">valid browsing context name or keyword</dfn> is any string
+ that is either a <a href="#valid-browsing-context-name">valid browsing context name</a> or that is
+ an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for one of: <code title="">_blank</code>, <code title="">_self</code>, <code title="">_parent</code>, or <code title="">_top</code>.</p><h3 id="the-window-object"><span class="secno">6.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></p><pre class="idl">[OverrideBuiltins]
+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>;
+ readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-self" title="dom-self">self</a>;
+ attribute DOMString <a href="#dom-name" title="dom-name">name</a>;
+ [PutForwards=href] readonly attribute <a href="history.html#location">Location</a> <a href="#dom-location" title="dom-location">location</a>;
+ readonly attribute <a href="history.html#history-0">History</a> <a href="#dom-history" title="dom-history">history</a>;
+ readonly attribute <a href="editing.html#undomanager">UndoManager</a> <a href="#dom-undomanager" title="dom-undoManager">undoManager</a>;
+ <a href="editing.html#selection-0">Selection</a> <a href="#dom-getselection" title="dom-getSelection">getSelection</a>();
+ [Replaceable] readonly attribute <a href="#barprop">BarProp</a> <a href="#dom-window-locationbar" title="dom-window-locationbar">locationbar</a>;
+ [Replaceable] readonly attribute <a href="#barprop">BarProp</a> <a href="#dom-window-menubar" title="dom-window-menubar">menubar</a>;
+ [Replaceable] readonly attribute <a href="#barprop">BarProp</a> <a href="#dom-window-personalbar" title="dom-window-personalbar">personalbar</a>;
+ [Replaceable] readonly attribute <a href="#barprop">BarProp</a> <a href="#dom-window-scrollbars" title="dom-window-scrollbars">scrollbars</a>;
+ [Replaceable] readonly attribute <a href="#barprop">BarProp</a> <a href="#dom-window-statusbar" title="dom-window-statusbar">statusbar</a>;
+ [Replaceable] readonly attribute <a href="#barprop">BarProp</a> <a href="#dom-window-toolbar" title="dom-window-toolbar">toolbar</a>;<!--
+ [Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-directories">directories</span>; // legacy (Gecko-only) -->
+ void <a href="#dom-window-close" title="dom-window-close">close</a>();
+ void <a href="#dom-window-focus" title="dom-window-focus">focus</a>();
+ void <a href="#dom-window-blur" title="dom-window-blur">blur</a>();
+
+ // other browsing contexts
+ [Replaceable] readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-frames" title="dom-frames">frames</a>;
+ [Replaceable] readonly attribute unsigned long <a href="#dom-length" title="dom-length">length</a>;
+ readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-top" title="dom-top">top</a>;
+ [Replaceable] readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-opener" title="dom-opener">opener</a>;
+ readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-parent" title="dom-parent">parent</a>;
+ readonly attribute <span>Element</span> <a href="#dom-frameelement" title="dom-frameElement">frameElement</a>;
+ <a href="#windowproxy">WindowProxy</a> <a href="#dom-open" title="dom-open">open</a>(in optional DOMString url, in optional DOMString target, in optional DOMString features, in optional DOMString replace);
+ <a href="#dom-window-item" title="dom-window-item">getter</a> <a href="#windowproxy">WindowProxy</a> (in unsigned long index);
+ <a href="#dom-window-nameditem" title="dom-window-namedItem">getter</a> <a href="#windowproxy">WindowProxy</a> (in DOMString name);
+
+ // the user agent
+ readonly attribute <a href="#navigator">Navigator</a> <a href="#dom-navigator" title="dom-navigator">navigator</a>; <!-- IE also has window.clientInformation === window.navigator -->
+ readonly attribute <a href="offline.html#applicationcache">ApplicationCache</a> <a href="#dom-applicationcache" title="dom-applicationCache">applicationCache</a>;
+
+ // user prompts
+ void <a href="#dom-alert" title="dom-alert">alert</a>(in DOMString message);
+ boolean <a href="#dom-confirm" title="dom-confirm">confirm</a>(in DOMString message);
+ DOMString <a href="#dom-prompt" title="dom-prompt">prompt</a>(in DOMString message, in optional DOMString default);
+ void <a href="#dom-print" title="dom-print">print</a>();
+ any <a href="#dom-showmodaldialog" title="dom-showModalDialog">showModalDialog</a>(in DOMString url, in optional any argument<!--, in optional DOMString features-->);
+
+ // <a href="comms.html#crossDocumentMessages">cross-document messaging</a>
+ void <a href="#dom-window-postmessage-2" title="dom-window-postMessage-2">postMessage</a>(in any message, in DOMString targetOrigin);
+ void <a href="#dom-window-postmessage-3" title="dom-window-postMessage-3">postMessage</a>(in any message, in <a href="comms.html#messageportarray">MessagePortArray</a> ports, in DOMString targetOrigin);
+
+ // <a href="#event-handler-idl-attributes">event handler IDL attributes</a>
+ attribute <a href="#function">Function</a> <a href="#handler-onabort" title="handler-onabort">onabort</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onafterprint" title="handler-window-onafterprint">onafterprint</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onbeforeprint" title="handler-window-onbeforeprint">onbeforeprint</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onbeforeunload" title="handler-window-onbeforeunload">onbeforeunload</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onblur" title="handler-window-onblur">onblur</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-oncanplay" title="handler-oncanplay">oncanplay</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-oncanplaythrough" title="handler-oncanplaythrough">oncanplaythrough</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onchange" title="handler-onchange">onchange</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onclick" title="handler-onclick">onclick</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-oncontextmenu" title="handler-oncontextmenu">oncontextmenu</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondblclick" title="handler-ondblclick">ondblclick</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondrag" title="handler-ondrag">ondrag</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondragend" title="handler-ondragend">ondragend</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondragenter" title="handler-ondragenter">ondragenter</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondragleave" title="handler-ondragleave">ondragleave</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondragover" title="handler-ondragover">ondragover</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondragstart" title="handler-ondragstart">ondragstart</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondrop" title="handler-ondrop">ondrop</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ondurationchange" title="handler-ondurationchange">ondurationchange</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onemptied" title="handler-onemptied">onemptied</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onended" title="handler-onended">onended</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onerror" title="handler-window-onerror">onerror</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onfocus" title="handler-window-onfocus">onfocus</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onformchange" title="handler-onformchange">onformchange</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onforminput" title="handler-onforminput">onforminput</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onhashchange" title="handler-window-onhashchange">onhashchange</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-oninput" title="handler-oninput">oninput</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-oninvalid" title="handler-oninvalid">oninvalid</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onkeydown" title="handler-onkeydown">onkeydown</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onkeypress" title="handler-onkeypress">onkeypress</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onkeyup" title="handler-onkeyup">onkeyup</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onload" title="handler-window-onload">onload</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onloadeddata" title="handler-onloadeddata">onloadeddata</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onloadedmetadata" title="handler-onloadedmetadata">onloadedmetadata</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onloadstart" title="handler-onloadstart">onloadstart</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onmessage" title="handler-window-onmessage">onmessage</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onmousedown" title="handler-onmousedown">onmousedown</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onmousemove" title="handler-onmousemove">onmousemove</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onmouseout" title="handler-onmouseout">onmouseout</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onmouseover" title="handler-onmouseover">onmouseover</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onmouseup" title="handler-onmouseup">onmouseup</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onmousewheel" title="handler-onmousewheel">onmousewheel</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onoffline" title="handler-window-onoffline">onoffline</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-ononline" title="handler-window-ononline">ononline</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onpause" title="handler-onpause">onpause</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onplay" title="handler-onplay">onplay</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onplaying" title="handler-onplaying">onplaying</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onpagehide" title="handler-window-onpagehide">onpagehide</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onpageshow" title="handler-window-onpageshow">onpageshow</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onpopstate" title="handler-window-onpopstate">onpopstate</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onprogress" title="handler-onprogress">onprogress</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onratechange" title="handler-onratechange">onratechange</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onreadystatechange" title="handler-onreadystatechange">onreadystatechange</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onredo" title="handler-window-onredo">onredo</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onresize" title="handler-window-onresize">onresize</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onscroll" title="handler-onscroll">onscroll</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onseeked" title="handler-onseeked">onseeked</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onseeking" title="handler-onseeking">onseeking</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onselect" title="handler-onselect">onselect</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onshow" title="handler-onshow">onshow</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onstalled" title="handler-onstalled">onstalled</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onstorage" title="handler-window-onstorage">onstorage</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onsubmit" title="handler-onsubmit">onsubmit</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onsuspend" title="handler-onsuspend">onsuspend</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-ontimeupdate" title="handler-ontimeupdate">ontimeupdate</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onundo" title="handler-window-onundo">onundo</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-window-onunload" title="handler-window-onunload">onunload</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>;
+ attribute <a href="#function">Function</a> <a href="#handler-onwaiting" title="handler-onwaiting">onwaiting</a>;
+};
+<a href="#window">Window</a> implements <span>EventTarget</span>;</pre><!-- for more features to add here, look here:
+ http://msdn.microsoft.com/workshop/author/dhtml/reference/objects/obj_window.asp
+ http://www.mozilla.org/docs/dom/domref/dom_window_ref.html
+ http://lxr.mozilla.org/mozilla/source/dom/public/idl/base/nsIDOMWindow.idl - scrollBy, etc
+ http://lxr.mozilla.org/mozilla/source/dom/public/idl/base/nsIDOMWindowInternal.idl - DOM level 0
+--><dl class="domintro"><dt><var title="">window</var> . <code title="dom-window"><a href="#dom-window">window</a></code></dt>
+ <dt><var title="">window</var> . <code title="dom-frames"><a href="#dom-frames">frames</a></code></dt>
+ <dt><var title="">window</var> . <code title="dom-self"><a href="#dom-self">self</a></code></dt>
+
+ <dd>
+
+ <p>These attributes all return <var title="">window</var>.</p>
+
+ </dd>
+
+ </dl><h4 id="apis-for-creating-and-navigating-browsing-contexts-by-name"><span class="secno">6.2.1 </span>APIs for creating and navigating browsing contexts by name</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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>
+
+ <p>Opens a window to show <var title="">url</var> (defaults to
+ <code><a href="#about:blank">about:blank</a></code>), and returns it. The <var title="">target</var> argument gives the name of the new
+ window. If a window exists with that name already, it is
+ reused. The <var title="">replace</var> attribute, if true, means
+ that whatever page is currently open in that window will be
+ removed from the window's session history. The <var title="">features</var> argument is ignored.</p>
+
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-name"><a href="#dom-name">name</a></code> [ = <var title="">value</var> ]</dt>
+
+ <dd>
+
+ <p>Returns the name of the window.</p>
+
+ <p>Can be set, to change the name.</p>
+
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-close">close</code>()</dt>
+
+ <dd>
+
+ <p>Closes the window.</p>
+
+ </dd>
+
+ </dl><h4 id="accessing-other-browsing-contexts"><span class="secno">6.2.2 </span>Accessing other browsing contexts</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><dl class="domintro"><dt><var title="">window</var> . <code title="dom-length"><a href="#dom-length">length</a></code></dt>
+
+ <dd>
+
+ <p>Returns the number of <a href="#child-browsing-context" title="child browsing
+ context">child browsing contexts</a>.</p>
+
+ </dd>
+
+ <dt><var title="">window</var>[<var title="">index</var>]</dt>
+
+ <dd>
+
+ <p>Returns the indicated <a href="#child-browsing-context">child browsing context</a>.</p>
+
+ </dd>
+
+ </dl><h4 id="named-access-on-the-window-object"><span class="secno">6.2.3 </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></p><dl class="domintro"><dt><var title="">window</var>[<var title="">name</var>]</dt>
+
+ <dd>
+
+ <p>Returns the indicated <a href="#child-browsing-context">child browsing context</a>.</p>
+
+ </dd>
+
+ </dl><h4 id="browser-interface-elements"><span class="secno">6.2.4 </span>Browser interface elements</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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><p>Each interface element is represented by a <code><a href="#barprop">BarProp</a></code>
+ object:</p><pre class="idl">interface <dfn id="barprop">BarProp</dfn> {
+ attribute boolean <a href="#dom-barprop-visible" title="dom-BarProp-visible">visible</a>;
+};</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-window-locationbar"><a href="#dom-window-locationbar">locationbar</a></code> . <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code></dt>
+ <dd>
+ <p>Returns true if the location bar is visible; otherwise, returns false.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-window-menubar"><a href="#dom-window-menubar">menubar</a></code> . <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code></dt>
+ <dd>
+ <p>Returns true if the menu bar is visible; otherwise, returns false.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-window-personalbar"><a href="#dom-window-personalbar">personalbar</a></code> . <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code></dt>
+ <!--<dt><var title="">window</var> . <code title="dom-window-directories">directories</code> . <code title="dom-BarProp-visible">visible</code></dt>-->
+ <dd>
+ <p>Returns true if the personal bar is visible; otherwise, returns false.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-window-scrollbars"><a href="#dom-window-scrollbars">scrollbars</a></code> . <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code></dt>
+ <dd>
+ <p>Returns true if the scroll bars are visible; otherwise, returns false.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-window-statusbar"><a href="#dom-window-statusbar">statusbar</a></code> . <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code></dt>
+ <dd>
+ <p>Returns true if the status bar is visible; otherwise, returns false.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-window-toolbar"><a href="#dom-window-toolbar">toolbar</a></code> . <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code></dt>
+ <dd>
+ <p>Returns true if the toolbar is visible; otherwise, returns false.</p>
+ </dd>
+
+ </dl><h4 id="relaxing-the-same-origin-restriction"><span class="secno">6.2.5 </span>Relaxing the same-origin restriction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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>
+
+ <p>Returns the current domain used for security checks.</p>
+
+ <p>Can be set to a value that removes subdomains, to allow pages
+ on other subdomains of the same domain (if they do the same thing)
+ to access each other.</p>
+
+ </dd>
+
+ </dl><p class="note">The <code title="dom-document-domain"><a href="#dom-document-domain">domain</a></code>
+ attribute is used to enable pages on different hosts of a domain to
+ access each others' DOMs.</p><p class="warning">Do not use the <code title="dom-document-domain"><a href="#dom-document-domain">document.domain</a></code> attribute when
+ using shared hosting. If an untrusted third party is able to host an
+ HTTP server at the same IP address but on a different port, then the
+ 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.</p><h3 id="scripting"><span class="secno">6.3 </span>Scripting</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><h4 id="introduction-2"><span class="secno">6.3.1 </span>Introduction</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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:</p><ul><li>Processing of <code><a href="semantics.html#script">script</a></code> elements.</li>
+
+ <li>Processing of inline <code title="javascript
+ protocol"><a href="#javascript-protocol">javascript:</a></code> URLs (e.g. the <code title="attr-img-src"><a href="text-level-semantics.html#attr-img-src">src</a></code> attribute of <code><a href="text-level-semantics.html#the-img-element">img</a></code>
+ elements, or an <code title="">@import</code> rule in a CSS
+ <code><a href="semantics.html#the-style-element">style</a></code> element block).</li>
+
+ <li>Event handlers, whether registered through the DOM using <code title="">addEventListener()</code>, by explicit <a href="#event-handler-content-attributes">event handler
+ content attributes</a>, by <a href="#event-handler-idl-attributes">event handler IDL
+ attributes</a>, or otherwise.</li>
+
+ <li>Processing of technologies like XBL or SVG that have their own
+ scripting features.</li>
+
+ </ul><h4 id="events"><span class="secno">6.3.2 </span>Events</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!--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
+ specified.</p><p>An <a href="#event-handlers" title="event handlers">event handler</a> can either
+ have the value null or be set to a <code><a href="#function">Function</a></code>
+ object. </p><p>Event handlers are exposed in one or two ways.</p><p>The first way, common to all event handlers, is as an <a href="#event-handler-idl-attributes" title="event handler IDL attributes">event handler IDL
+ attribute</a>.</p><p>The second way is as an <a href="#event-handler-content-attributes" title="event handler content
+ attributes">event handler content attribute</a>. Event handlers
+ on <a href="infrastructure.html#html-elements">HTML elements</a> and some of the event handlers on
+ <code><a href="#window">Window</a></code> objects are exposed in this way.</p><p><dfn id="event-handler-content-attributes">Event handler content attributes</dfn>, when specified, must
+ contain valid JavaScript code matching the <code title="">FunctionBody</code> production. <a href="references.html#refsECMA262">[ECMA262]</a></p><p class="note">When an <a href="#event-handler-content-attributes" title="event handler content
+ attributes">event handler content attribute</a> is set on an
+ element owned by a <code>Document</code> that is not in a
+ <a href="#browsing-context">browsing context</a>, the corresponding event handler is
+ not changed.</p><!-- v2: we should probably support HTML4's Content-Script-Type header here. --><h3 id="timers"><span class="secno">6.4 </span>Timers</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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.</p><pre class="idl">[Supplemental, NoInterfaceObject]
+interface <dfn id="windowtimers">WindowTimers</dfn> {
+ long <a href="#dom-windowtimers-settimeout" title="dom-windowtimers-setTimeout">setTimeout</a>(in any handler, in optional any timeout, in any... args);
+ void <a href="#dom-windowtimers-cleartimeout" title="dom-windowtimers-clearTimeout">clearTimeout</a>(in long handle);
+ long <a href="#dom-windowtimers-setinterval" title="dom-windowtimers-setInterval">setInterval</a>(in any handler, in optional any timeout, in any... args);
+ void <a href="#dom-windowtimers-clearinterval" title="dom-windowtimers-clearInterval">clearInterval</a>(in long handle);
+};
+<a href="#window">Window</a> implements <a href="#windowtimers">WindowTimers</a>;</pre><dl class="domintro"><dt><var title="">handle</var> = <var title="">window</var> . <code title="dom-windowtimers-setTimeout"><a href="#dom-windowtimers-settimeout">setTimeout</a></code>( <var title="">handler</var> [, <var title="">timeout</var> [, <var title="">arguments</var> ] ] )</dt>
+
+ <dd>
+
+ <p>Schedules a timeout to run <var title="">handler</var> after
+ <var title="">timeout</var> milliseconds. Any <var title="">arguments</var> are passed straight through to the <var title="">handler</var>.</p>
+
+ </dd>
+
+ <dt><var title="">handle</var> = <var title="">window</var> . <code title="dom-windowtimers-setTimeout"><a href="#dom-windowtimers-settimeout">setTimeout</a></code>( <var title="">code</var> [, <var title="">timeout</var> ] )</dt>
+
+ <dd>
+
+ <p>Schedules a timeout to compile and run <var title="">code</var>
+ after <var title="">timeout</var> milliseconds.</p>
+
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-windowtimers-clearTimeout"><a href="#dom-windowtimers-cleartimeout">clearTimeout</a></code>( <var title="">handle</var> )</dt>
+
+ <dd>
+
+ <p>Cancels the timeout set with <code title="dom-windowtimers-setTimeout"><a href="#dom-windowtimers-settimeout">setTimeout()</a></code> identified by <var title="">handle</var>.</p>
+
+ </dd>
+
+ <dt><var title="">handle</var> = <var title="">window</var> . <code title="dom-windowtimers-setInterval"><a href="#dom-windowtimers-setinterval">setInterval</a></code>( <var title="">handler</var> [, <var title="">timeout</var> [, <var title="">arguments</var> ] ] )</dt>
+
+ <dd>
+
+ <p>Schedules a timeout to run <var title="">handler</var> every
+ <var title="">timeout</var> milliseconds. Any <var title="">arguments</var> are passed straight through to the <var title="">handler</var>.</p>
+
+ </dd>
+
+ <dt><var title="">handle</var> = <var title="">window</var> . <code title="dom-windowtimers-setInterval"><a href="#dom-windowtimers-setinterval">setInterval</a></code>( <var title="">code</var> [, <var title="">timeout</var> ] )</dt>
+
+ <dd>
+
+ <p>Schedules a timeout to compile and run <var title="">code</var>
+ every <var title="">timeout</var> milliseconds.</p>
+
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-windowtimers-clearInterval"><a href="#dom-windowtimers-clearinterval">clearInterval</a></code>( <var title="">handle</var> )</dt>
+
+ <dd>
+
+ <p>Cancels the timeout set with <code title="dom-windowtimers-setInterval"><a href="#dom-windowtimers-setinterval">setInterval()</a></code> identified by <var title="">handle</var>.</p>
+
+ </dd>
+
+ </dl><p class="note">This API does not guarantee that timers will fire
+ exactly on schedule. Delays due to CPU load, other tasks, etc, are
+ to be expected.</p><h3 id="user-prompts"><span class="secno">6.5 </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">6.5.1 </span>Simple dialogs</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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>
+
+ <p>A call to the <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">navigator.yieldForStorageUpdates()</a></code>
+ method is implied when this method is invoked.</p>
+
+ </dd>
+
+ <dt><var title="">result</var> = <var title="">window</var> . <code title="dom-confirm"><a href="#dom-confirm">confirm</a></code>(<var title="">message</var>)</dt>
+ <dd>
+
+ <p>Displays a modal OK/Cancel prompt with the given message, waits
+ for the user to dismiss it, and returns true if the user clicks OK
+ and false if the user clicks Cancel.</p>
+
+ <p>A call to the <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">navigator.yieldForStorageUpdates()</a></code>
+ method is implied when this method is invoked.</p>
+
+ </dd>
+
+ <dt><var title="">result</var> = <var title="">window</var> . <code title="dom-prompt"><a href="#dom-prompt">prompt</a></code>(<var title="">message</var> [, <var title="">default</var>] )</dt>
+ <dd>
+
+ <p>Displays a modal text field prompt with the given message,
+ waits for the user to dismiss it, and returns the value that the
+ user entered. If the user cancels the prompt, then returns null
+ instead. If the second argument is present, then the given value
+ is used as a default.</p>
+
+ <p>A call to the <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">navigator.yieldForStorageUpdates()</a></code>
+ method is implied when this method is invoked.</p>
+
+ </dd>
+
+ </dl><h4 id="printing"><span class="secno">6.5.2 </span>Printing</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><dl class="domintro"><dt><var title="">window</var> . <code title="dom-print"><a href="#dom-print">print</a></code>()</dt>
+
+ <dd>
+
+ <p>Prompts the user to print the page.</p>
+
+ <p>A call to the <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">navigator.yieldForStorageUpdates()</a></code>
+ method is implied when this method is invoked.</p>
+
+ </dd>
+
+ </dl><h4 id="dialogs-implemented-using-separate-documents"><span class="secno">6.5.3 </span>Dialogs implemented using separate documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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>
+
+ <p>Prompts the user with the given page, waits for that page to
+ close, and returns the return value.</p>
+
+ <p>A call to the <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">navigator.yieldForStorageUpdates()</a></code>
+ method is implied when this method is invoked.</p>
+
+ </dd>
+
+ </dl><pre class="idl">[Supplemental, NoInterfaceObject] interface <dfn id="windowmodal">WindowModal</dfn> {
+ readonly attribute any <a href="#dom-windowmodal-dialogarguments" title="dom-WindowModal-dialogArguments">dialogArguments</a>;
+ attribute DOMString <a href="#dom-windowmodal-returnvalue" title="dom-WindowModal-returnValue">returnValue</a>;
+};
+<a href="#window">Window</a> implements <a href="#windowmodal">WindowModal</a>; /* sometimes */</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-WindowModal-dialogArguments"><a href="#dom-windowmodal-dialogarguments">dialogArguments</a></code></dt>
+
+ <dd>
+
+ <p>Returns the <var title="">argument</var> argument that was
+ passed to the <code title="dom-showModalDialog"><a href="#dom-showmodaldialog">showModalDialog()</a></code> method.</p>
+
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-WindowModal-returnValue"><a href="#dom-windowmodal-returnvalue">returnValue</a></code> [ = <var title="">value</var> ]</dt>
+
+ <dd>
+
+ <p>Returns the current return value for the window.</p>
+
+ <p>Can be set, to change the value that will be returned by the
+ <code title="dom-showModalDialog"><a href="#dom-showmodaldialog">showModalDialog()</a></code>
+ method.</p>
+
+ </dd>
+
+ </dl><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.</p><h3 id="system-state-and-capabilities"><span class="secno">6.6 </span>System state and capabilities</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><pre class="idl">interface <dfn id="navigator">Navigator</dfn> {
+ // objects implementing this interface also implement the interfaces given below
+};
+<a href="#navigator">Navigator</a> implements <a href="#navigatorid">NavigatorID</a>;
+<a href="#navigator">Navigator</a> implements <a href="#navigatoronline">NavigatorOnLine</a>;
+<a href="#navigator">Navigator</a> implements <a href="#navigatorabilities">NavigatorAbilities</a>;
+
+[Supplemental, NoInterfaceObject]
+interface <dfn id="navigatorid">NavigatorID</dfn> {<!--
+ readonly attribute DOMString <span title="dom-navigator-appCodeName">appCodeName</span>;-->
+ readonly attribute DOMString <a href="#dom-navigator-appname" title="dom-navigator-appName">appName</a>;
+ readonly attribute DOMString <a href="#dom-navigator-appversion" title="dom-navigator-appVersion">appVersion</a>;
+ readonly attribute DOMString <a href="#dom-navigator-platform" title="dom-navigator-platform">platform</a>;
+ readonly attribute DOMString <a href="#dom-navigator-useragent" title="dom-navigator-userAgent">userAgent</a>;
+};
+
+[Supplemental, NoInterfaceObject]
+interface <dfn id="navigatoronline">NavigatorOnLine</dfn> {
+ readonly attribute boolean <a href="#dom-navigator-online" title="dom-navigator-onLine">onLine</a>;
+};
+
+[Supplemental, NoInterfaceObject]
+interface <dfn id="navigatorabilities">NavigatorAbilities</dfn> {
+ // content handler registration
+ void <a href="#dom-navigator-registerprotocolhandler" title="dom-navigator-registerProtocolHandler">registerProtocolHandler</a>(in DOMString scheme, in DOMString url, in DOMString title);
+ void <a href="#dom-navigator-registercontenthandler" title="dom-navigator-registerContentHandler">registerContentHandler</a>(in DOMString mimeType, in DOMString url, in DOMString title);
+ void <a href="#dom-navigator-yieldforstorageupdates" title="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates</a>();
+<!-- v2: cookieEnabled geolocator javaEnabled mozIsLocallyAvailable preference
+ readonly attribute <span>MimeTypeArray</span> <span title="dom-navigator-mimeTypes">mimeTypes</span>;
+ readonly attribute <span>PluginArray</span> <span title="dom-navigator-plugins">plugins</span>;
+ (the latter is used in a <video> element demo now, so we might need to pull this forward from v2!)
+-->};</pre><h4 id="client-identification"><span class="secno">6.6.1 </span>Client identification</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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><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
+ to work around these issues.</p><p>Client detection should always be limited to detecting known
+ current versions; future versions and unknown versions should always
+ be assumed to be fully compliant.</p><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-appName"><a href="#dom-navigator-appname">appName</a></code></dt>
+ <dd>
+ <p>Returns the name of the browser.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-appVersion"><a href="#dom-navigator-appversion">appVersion</a></code></dt>
+ <dd>
+ <p>Returns the version of the browser.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-platform"><a href="#dom-navigator-platform">platform</a></code></dt>
+ <dd>
+ <p>Returns the name of the platform.</p>
+ </dd>
+
+ <dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-userAgent"><a href="#dom-navigator-useragent">userAgent</a></code></dt>
+ <dd>
+ <p>Returns the complete User-Agent header.</p>
+ </dd>
+
+ </dl><h4 id="custom-handlers"><span class="secno">6.6.2 </span>Custom scheme and content handlers</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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="references.html#refsRFC2806">[RFC2806]</a>), so that if the user clicks on
+ such a link, he is given the opportunity to use that Web
+ site. Analogously, the <dfn id="dom-navigator-registercontenthandler" title="dom-navigator-registerContentHandler"><code>registerContentHandler()</code></dfn>
+ method allows Web sites to register themselves as possible handlers
+ for content in a particular <a href="infrastructure.html#mime-type">MIME type</a>. For example, the same online
+ fax service could register itself as a handler for
+ <code>image/g3fax</code> files (<a href="references.html#refsRFC1494">[RFC1494]</a>), so that if the user has no
+ native application capable of handling G3 Facsimile byte streams,
+ his Web browser can instead suggest he use that site to view the
+ image.</p><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-registerProtocolHandler"><a href="#dom-navigator-registerprotocolhandler">registerProtocolHandler</a></code>(<var title="">scheme</var>, <var title="">url</var>, <var title="">title</var>)</dt>
+ <dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-registerContentHandler"><a href="#dom-navigator-registercontenthandler">registerContentHandler</a></code>(<var title="">mimeType</var>, <var title="">url</var>, <var title="">title</var>)</dt>
+
+ <dd>
+
+ <p>Registers a handler for the given scheme or content type, at
+ the given URL, with the given title.</p>
+
+ <p>The string "<code title="">%s</code>" in the URL is used as a
+ placeholder for where to put the URL of the content to be
+ handled.</p>
+
+ <p>Throws a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception if the user agent
+ blocks the registration (this might happen if trying to register
+ as a handler for "http", for instance).</p>
+
+ <p>Throws a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> if the "<code title="">%s</code>" string is missing in the URL.</p>
+
+ </dd>
+
+ </dl><h4 id="manually-releasing-the-storage-mutex"><span class="secno">6.6.3 </span>Manually releasing the storage mutex</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><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>
+
+ <p>If a script uses the <code title="dom-document-cookie"><a href="#dom-document-cookie">document.cookie</a></code> API, or the
+ <code title="dom-localStorage">localStorage</code> API, the
+ browser will block other scripts from accessing cookies or storage
+ until the first script finishes.</p>
+
+ <p>Calling the <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">navigator.yieldForStorageUpdates()</a></code>
+ method tells the user agent to unblock any other scripts that may
+ be blocked, even though the script hasn't returned.</p>
+
+ <p>Values of cookies and items in the <code>Storage</code> objects
+ of <code title="dom-localStorage">localStorage</code> attributes
+ can change after calling this method, whence its name.</p>
+
+ </dd>
+
+ </dl></body></html>
\ No newline at end of file
Index: semantics.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/semantics.html,v
retrieving revision 1.502
retrieving revision 1.503
diff -u -d -r1.502 -r1.503
--- semantics.html 21 Nov 2009 14:47:41 -0000 1.502
+++ semantics.html 21 Nov 2009 15:03:28 -0000 1.503
@@ -600,4 +600,2618 @@
described in the following sections. If a <code><a href="#meta">meta</a></code> element
has no <code title="attr-meta-content"><a href="#attr-meta-content">content</a></code> attribute,
then the value part of the metadata name/value pair is the empty
- string.</p><h5 id="standard-metadata-names"><span class="secno">4.2.5.1 </span>Standard metadata names</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>This specification defines a few names for the <code title="attr-meta-name"><a href="#attr-meta-name">name</a></code> attr
\ No newline at end of file
+ string.</p><h5 id="standard-metadata-names"><span class="secno">4.2.5.1 </span>Standard metadata names</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>This specification defines a few names for the <code title="attr-meta-name"><a href="#attr-meta-name">name</a></code> attribute of the
+ <code><a href="#meta">meta</a></code> element.</p><p>Names are case-insensitive, and must be compared
+ in an </p><dl><dt><dfn id="meta-application-name" title="meta-application-name"><code>application-name</code></dfn></dt>
+
+ <dd><p>The value must be a short free-form string giving the name
+ of the Web application that the page represents. If the page is not
[...2590 lines suppressed...]
+
+ <pre><article lang="en-US">
+ <h1>My use of language and my cats</h1>
+ <p>My cat's behavior hasn't changed much since her absence, except
+ that she plays her new physique to the neighbors regularly, in an
+ attempt to get pets.</p>
+ <div lang="en-GB">
+ <p>My other cat, coloured black and white, is a sweetie. He followed
+ us to the pool today, walking down the pavement with us. Yesterday
+ he apparently visited our neighbours. I wonder if he recognises that
+ their flat is a mirror image of ours.</p>
+ <p>Hm, I just noticed that in the last paragraph I used British
+ English. But I'm supposed to write in American English. So I
+ shouldn't say "pavement" or "flat" or "colour"...</p>
+ </div>
+ <p>I should say "sidewalk" and "apartment" and "color"!</p>
+</article></pre>
+
+ </div></body></html>
\ No newline at end of file
Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.html,v
retrieving revision 1.507
retrieving revision 1.508
diff -u -d -r1.507 -r1.508
--- spec.html 21 Nov 2009 14:47:41 -0000 1.507
+++ spec.html 21 Nov 2009 15:03:28 -0000 1.508
@@ -63,4 +63,30601 @@
h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
h1 + h2, hr + h2.no-toc { page-break-before: auto; }
- p > span:not([title=""]):not([class="XXX"]):not([class="impl"]), li > span:not([title=""]):not([class="XXX"]):not([class=
\ No newline at end of file
+ p > span:not([title=""]):not([class="XXX"]):not([class="impl"]), li > span:not([title=""]):not([class="XXX"]):not([class="impl"]) { border-bottom: solid #9999CC; }
+
+ div.head { margin: 0 0 1em; padding: 1em 0 0 0; }
+ div.head p { margin: 0; }
+ div.head h1 { margin: 0; }
+ div.head .logo { float: right; margin: 0 1em; }
[...30573 lines suppressed...]
+ v2 * make the spec consistent about whether the word "algorithm" is part of
+ an algorithm's name or not ("</dfn> algorithm", "</span> algorithm")
+ v2 * make the spec more consistent about its use of "hexadecimal"
+ and "base-sixteen", the order that 0-9 A-Z a-z is mentioned,
+ and the detail to which the spec explains how to interpret a
+ string as a hexadecimal number.
+ v2 * become more consistent about what markup we use to mark up
+ productions (nothing? <i>? <code>?)
+ v2 * use <code>Document</code> consistently instead of 'document'.
+ v2 * s/raise/throw/g
+ v2 * be clearer about arrays/lists/collections being zero-based
+ despite using the term "/index/th".
+ v2 * use the sample widgets:
+ <li><img alt="A text field with editable sections for each
+ value, with a button to pop up a dialog showing a calendar or
+ clock." src="sample-datetime-ui-2"></li>
+ <li><img alt="A calendar grid with a clock in the upper right
+ hand corner." src="sample-datetime-ui-3"></li>
+--></body></html>
\ No newline at end of file
Received on Saturday, 21 November 2009 15:03:38 UTC