[html5] r8160 - [giow] (3) Provide hook for pagevis. Correctly return false for event.persisted [...]
whatwg at whatwg.org
whatwg at whatwg.org
Sat Aug 31 14:43:18 PDT 2013
Author: ianh
Date: 2013-08-31 14:43:16 -0700 (Sat, 31 Aug 2013)
New Revision: 8160
Modified:
complete.html
index
source
Log:
[giow] (3) Provide hook for pagevis. Correctly return false for event.persisted in pagehide. Define one of the variables in an algorithm.
Affected topics: HTML, HTML Syntax and Parsing
Modified: complete.html
===================================================================
--- complete.html 2013-08-29 22:21:12 UTC (rev 8159)
+++ complete.html 2013-08-31 21:43:16 UTC (rev 8160)
@@ -256,7 +256,7 @@
<header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 29 August 2013</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 31 August 2013</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -68652,6 +68652,15 @@
<li><p>Set the <code><a href=#document>Document</a></code>'s <a href=#page-showing>page showing</a> flag to true.</li>
+ <li>
+
+ <p>Run any <dfn id=session-history-document-visibility-change-steps>session history document visibility change steps</dfn> for <code><a href=#document>Document</a></code> that
+ are defined by <a href=#other-applicable-specifications>other applicable specifications</a>.</p>
+
+ <p class=note>This is specifically intended for use by the Page Visibility specification. <a href=#refsPAGEVIS>[PAGEVIS]</a></p>
+
+ </li>
+
<li><p><a href=#concept-event-fire title=concept-event-fire>Fire</a> a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event with the name <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code> at the <code><a href=#window>Window</a></code> object of that
<code><a href=#document>Document</a></code>, but with its <code title=dom-event-target><a href=#dom-event-target>target</a></code> set to the
<code><a href=#document>Document</a></code> object (and the <code title=dom-event-currentTarget>currentTarget</code> set to the <code><a href=#window>Window</a></code> object),
@@ -68832,11 +68841,25 @@
<dd>
- <p>Returns false if the page is newly being loaded (and the <code title=event-load>load</code>
- event will fire). Otherwise, returns true.</p>
+ <p>For the <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code> event, returns false if the page is
+ newly being loaded (and the <code title=event-load>load</code> event will fire). Otherwise,
+ returns true.</p>
- </dd>
+ <p>For the <code title=event-pagehide><a href=#event-pagehide>pagehide</a></code> event, returns false if the page is
+ going away for the last time. Otherwise, returns true, meaning that (if nothing conspires to
+ make the page unsalvageable) the page might be reused if the user navigates back to this
+ page.</p>
+ <p>Things that can cause the page to be unsalvageable include:</p>
+
+ <ul class=brief><li><code title=dom-document-open><a href=#dom-document-open>document.open()</a></code>
+ <li>Listening for <code title=event-beforeunload>beforeunload</code> events
+ <li>Listening for <code title=event-unload>unload</code> events
+ <li>Having <code><a href=#the-iframe-element>iframe</a></code>s that are not salvageable
+ <li>Active <code><a href=#websocket>WebSocket</a></code> objects
+ <li><a href=#abort-a-document title="abort a document">Aborting a <code>Document</code></a>
+ </ul></dd>
+
</dl><div class=impl>
<p>The <dfn id=dom-pagetransitionevent-persisted title=dom-PageTransitionEvent-persisted><code>persisted</code></dfn> attribute must
@@ -68949,7 +68972,8 @@
<code><a href=#document>Document</a></code> object (and the <code title=dom-event-currentTarget>currentTarget</code>
set to the <code><a href=#window>Window</a></code> object), using the <code><a href=#pagetransitionevent>PageTransitionEvent</a></code> interface,
with the <code title=dom-PageTransitionEvent-persisted><a href=#dom-pagetransitionevent-persisted>persisted</a></code> attribute initialized
- to true. This event must not bubble, must not be cancelable, and has no default action.</li>
+ to true if the <code><a href=#document>Document</a></code> object's <i title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></i> state is true, and false otherwise. This
+ event must not bubble, must not be cancelable, and has no default action.</li>
<li>
@@ -86620,7 +86644,7 @@
<dd><p>All other elements found while parsing an HTML document.</dd>
</dl><p>The <a href=#stack-of-open-elements>stack of open elements</a> is said to <dfn id=has-an-element-in-the-specific-scope title="has an element in the specific
- scope">have an element in a specific scope</dfn> consisting of a list of element types <var title="">list</var> when the following algorithm terminates in a match state:</p>
+ scope">have an element <var title="">target node</var> in a specific scope</dfn> consisting of a list of element types <var title="">list</var> when the following algorithm terminates in a match state:</p>
<ol><li><p>Initialize <var title="">node</var> to be the <a href=#current-node>current node</a> (the bottommost
node of the stack).</li>
Modified: index
===================================================================
--- index 2013-08-29 22:21:12 UTC (rev 8159)
+++ index 2013-08-31 21:43:16 UTC (rev 8160)
@@ -256,7 +256,7 @@
<header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 29 August 2013</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 31 August 2013</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -68652,6 +68652,15 @@
<li><p>Set the <code><a href=#document>Document</a></code>'s <a href=#page-showing>page showing</a> flag to true.</li>
+ <li>
+
+ <p>Run any <dfn id=session-history-document-visibility-change-steps>session history document visibility change steps</dfn> for <code><a href=#document>Document</a></code> that
+ are defined by <a href=#other-applicable-specifications>other applicable specifications</a>.</p>
+
+ <p class=note>This is specifically intended for use by the Page Visibility specification. <a href=#refsPAGEVIS>[PAGEVIS]</a></p>
+
+ </li>
+
<li><p><a href=#concept-event-fire title=concept-event-fire>Fire</a> a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event with the name <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code> at the <code><a href=#window>Window</a></code> object of that
<code><a href=#document>Document</a></code>, but with its <code title=dom-event-target><a href=#dom-event-target>target</a></code> set to the
<code><a href=#document>Document</a></code> object (and the <code title=dom-event-currentTarget>currentTarget</code> set to the <code><a href=#window>Window</a></code> object),
@@ -68832,11 +68841,25 @@
<dd>
- <p>Returns false if the page is newly being loaded (and the <code title=event-load>load</code>
- event will fire). Otherwise, returns true.</p>
+ <p>For the <code title=event-pageshow><a href=#event-pageshow>pageshow</a></code> event, returns false if the page is
+ newly being loaded (and the <code title=event-load>load</code> event will fire). Otherwise,
+ returns true.</p>
- </dd>
+ <p>For the <code title=event-pagehide><a href=#event-pagehide>pagehide</a></code> event, returns false if the page is
+ going away for the last time. Otherwise, returns true, meaning that (if nothing conspires to
+ make the page unsalvageable) the page might be reused if the user navigates back to this
+ page.</p>
+ <p>Things that can cause the page to be unsalvageable include:</p>
+
+ <ul class=brief><li><code title=dom-document-open><a href=#dom-document-open>document.open()</a></code>
+ <li>Listening for <code title=event-beforeunload>beforeunload</code> events
+ <li>Listening for <code title=event-unload>unload</code> events
+ <li>Having <code><a href=#the-iframe-element>iframe</a></code>s that are not salvageable
+ <li>Active <code><a href=#websocket>WebSocket</a></code> objects
+ <li><a href=#abort-a-document title="abort a document">Aborting a <code>Document</code></a>
+ </ul></dd>
+
</dl><div class=impl>
<p>The <dfn id=dom-pagetransitionevent-persisted title=dom-PageTransitionEvent-persisted><code>persisted</code></dfn> attribute must
@@ -68949,7 +68972,8 @@
<code><a href=#document>Document</a></code> object (and the <code title=dom-event-currentTarget>currentTarget</code>
set to the <code><a href=#window>Window</a></code> object), using the <code><a href=#pagetransitionevent>PageTransitionEvent</a></code> interface,
with the <code title=dom-PageTransitionEvent-persisted><a href=#dom-pagetransitionevent-persisted>persisted</a></code> attribute initialized
- to true. This event must not bubble, must not be cancelable, and has no default action.</li>
+ to true if the <code><a href=#document>Document</a></code> object's <i title=concept-document-salvageable><a href=#concept-document-salvageable>salvageable</a></i> state is true, and false otherwise. This
+ event must not bubble, must not be cancelable, and has no default action.</li>
<li>
@@ -86620,7 +86644,7 @@
<dd><p>All other elements found while parsing an HTML document.</dd>
</dl><p>The <a href=#stack-of-open-elements>stack of open elements</a> is said to <dfn id=has-an-element-in-the-specific-scope title="has an element in the specific
- scope">have an element in a specific scope</dfn> consisting of a list of element types <var title="">list</var> when the following algorithm terminates in a match state:</p>
+ scope">have an element <var title="">target node</var> in a specific scope</dfn> consisting of a list of element types <var title="">list</var> when the following algorithm terminates in a match state:</p>
<ol><li><p>Initialize <var title="">node</var> to be the <a href=#current-node>current node</a> (the bottommost
node of the stack).</li>
Modified: source
===================================================================
--- source 2013-08-29 22:21:12 UTC (rev 8159)
+++ source 2013-08-31 21:43:16 UTC (rev 8160)
@@ -76641,6 +76641,16 @@
<li><p>Set the <code>Document</code>'s <span>page showing</span> flag to true.</p></li>
+ <li>
+
+ <p>Run any <dfn>session history document visibility change steps</dfn> for <code>Document</code> that
+ are defined by <span>other applicable specifications</span>.</p>
+
+ <p class="note">This is specifically intended for use by the Page Visibility specification. <a
+ href="#refsPAGEVIS">[PAGEVIS]</a></p>
+
+ </li>
+
<li><p><span title="concept-event-fire">Fire</span> a <span
title="concept-events-trusted">trusted</span> event with the name <code
title="event-pageshow">pageshow</code> at the <code>Window</code> object of that
@@ -76867,9 +76877,26 @@
<dd>
- <p>Returns false if the page is newly being loaded (and the <code title="event-load">load</code>
- event will fire). Otherwise, returns true.</p>
+ <p>For the <code title="event-pageshow">pageshow</code> event, returns false if the page is
+ newly being loaded (and the <code title="event-load">load</code> event will fire). Otherwise,
+ returns true.</p>
+ <p>For the <code title="event-pagehide">pagehide</code> event, returns false if the page is
+ going away for the last time. Otherwise, returns true, meaning that (if nothing conspires to
+ make the page unsalvageable) the page might be reused if the user navigates back to this
+ page.</p>
+
+ <p>Things that can cause the page to be unsalvageable include:</p>
+
+ <ul class="brief">
+ <li><code title="dom-document-open">document.open()</code>
+ <li>Listening for <code title="event-beforeunload">beforeunload</code> events
+ <li>Listening for <code title="event-unload">unload</code> events
+ <li>Having <code>iframe</code>s that are not salvageable
+ <li>Active <code>WebSocket</code> objects
+ <li><span title="abort a document">Aborting a <code>Document</code></span>
+ </ul>
+
</dd>
</dl>
@@ -77004,7 +77031,9 @@
<code>Document</code> object (and the <code title="dom-event-currentTarget">currentTarget</code>
set to the <code>Window</code> object), using the <code>PageTransitionEvent</code> interface,
with the <code title="dom-PageTransitionEvent-persisted">persisted</code> attribute initialized
- to true. This event must not bubble, must not be cancelable, and has no default action.</p></li>
+ to true if the <code>Document</code> object's <i
+ title="concept-document-salvageable">salvageable</i> state is true, and false otherwise. This
+ event must not bubble, must not be cancelable, and has no default action.</p></li>
<li>
@@ -96664,7 +96693,7 @@
</dl>
<p>The <span>stack of open elements</span> is said to <dfn title="has an element in the specific
- scope">have an element in a specific scope</dfn> consisting of a list of element types <var
+ scope">have an element <var title="">target node</var> in a specific scope</dfn> consisting of a list of element types <var
title="">list</var> when the following algorithm terminates in a match state:</p>
<ol>
More information about the Commit-Watchers
mailing list