[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

git-svn-id: http://svn.whatwg.org/webapps@8160 340c8d12-0b0e-0410-8428-c7bf67bfef74

Author: Hixie

complete.html

@@ -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 &mdash; Last Updated 29 August 2013</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; 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 @@ <h4 id=history-traversal><span class=secno>6.6.10 </span>History traversal</h4>
 
        <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,10 +68841,24 @@ <h5 id=event-definitions-1><span class=secno>6.6.10.1 </span>Event definitions</
 
    <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>
 
@@ -68949,7 +68972,8 @@ <h4 id=unloading-documents><span class=secno>6.6.11 </span>Unloading documents</
    <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 @@ <h5 id=the-insertion-mode><span class=secno>12.2.3.1 </span>The insertion mode</
    <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>

index

@@ -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 &mdash; Last Updated 29 August 2013</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; 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 @@ State: &lt;OUTPUT NAME=I&gt;1&lt;/OUTPUT&gt; &lt;INPUT VALUE="Increment" TYPE=BU
 
        <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,10 +68841,24 @@ dictionary <dfn id=pagetransitioneventinit>PageTransitionEventInit</dfn> : <a hr
 
    <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>
 
@@ -68949,7 +68972,8 @@ dictionary <dfn id=pagetransitioneventinit>PageTransitionEventInit</dfn> : <a hr
    <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 @@ dictionary <dfn id=storageeventinit>StorageEventInit</dfn> : <a href=#eventinit>
    <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>

source

@@ -76641,6 +76641,16 @@ State: <OUTPUT NAME=I>1</OUTPUT> <INPUT VALUE="Increment" TYPE=BUTTON O
 
        <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,8 +76877,25 @@ dictionary <dfn>PageTransitionEventInit</dfn> : <span>EventInit</span> {
 
    <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>
 
@@ -77004,7 +77031,9 @@ dictionary <dfn>PageTransitionEventInit</dfn> : <span>EventInit</span> {
    <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 @@ dictionary <dfn>StorageEventInit</dfn> : <span>EventInit</span> {
   </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>