Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add pagereveal event #9818

Merged
merged 15 commits into from
Dec 15, 2023
Merged

Add pagereveal event #9818

Changes from 3 commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
e9b3af0
WIP-reveal
noamr Oct 1, 2023
c586460
Add PageRevealEvent interface with viewTransition
noamr Oct 16, 2023
9e4ba26
Add constructor
noamr Oct 21, 2023
29bb5c3
Fix copy-paste error
noamr Oct 23, 2023
bb5e16e
Add note for cached frames
noamr Oct 23, 2023
d35be09
Associate view-transition with event
noamr Oct 26, 2023
7dd7570
Apply vt2 changes
noamr Oct 26, 2023
a17da55
Apply vt2 changes
noamr Oct 26, 2023
65495ff
Fix a few nits
noamr Nov 17, 2023
d5ba58f
nits
noamr Nov 17, 2023
3d13fe9
Add domintro
noamr Nov 23, 2023
0b234c5
nits
noamr Dec 8, 2023
fc7fc9c
Move pagerveal to own h5
noamr Dec 8, 2023
77e9459
Move event interface into section
noamr Dec 8, 2023
9650e50
Rearrange a bit more and remove a period
domenic Dec 13, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 69 additions & 0 deletions source
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4023,6 +4023,9 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
<ul class="brief">
domenic marked this conversation as resolved.
Show resolved Hide resolved
<li><dfn data-x-href="https://drafts.csswg.org/css-view-transitions/#perform-pending-transition-operations">perform pending transition operations</dfn></li>
<li><dfn data-x-href="https://drafts.csswg.org/css-view-transitions/#document-rendering-suppression-for-view-transitions">rendering suppression for view transitions</dfn></li>
<li><dfn data-x-href="https://drafts.csswg.org/css-view-transitions/#document-active-view-transition">active view transition</dfn></li>
noamr marked this conversation as resolved.
Show resolved Hide resolved
<li><dfn data-x-href="https://drafts.csswg.org/css-view-transitions/#viewtransition">ViewTransition</dfn></li>
<li><dfn data-x-href="https://drafts.csswg.org/css-view-transitions-2/#viewtransition-is-inbound-cross-document-transition">is inbound cross-document view-transition</dfn></li>
noamr marked this conversation as resolved.
Show resolved Hide resolved
</ul>
noamr marked this conversation as resolved.
Show resolved Hide resolved

<p>The term <dfn data-x="css-styling-attribute"
Expand Down Expand Up @@ -93581,6 +93584,36 @@ dictionary <dfn dictionary>PageTransitionEventInit</dfn> : <span>EventInit</span
</div>


<h5>The <code>PageRevealEvent</code> interface</h5>

<pre><code class="idl">[Exposed=Window]
interface <dfn interface>PageRevealEvent</dfn> : <span>Event</span> {
constructor(DOMString type, optional <span>PageRevealEventInit</span> eventInitDict = {});
noamr marked this conversation as resolved.
Show resolved Hide resolved
readonly attribute <code>ViewTransition</code> <span data-x="dom-PageRevealEvent-viewTransition">viewTransition</span>;
domenic marked this conversation as resolved.
Show resolved Hide resolved
};

dictionary <dfn dictionary>PageRevealEventInit</dfn> : <span>EventInit</span> {
<code>ViewTransition</code> <dfn dict-member for="PopStateEventInit" data-x="dom-PageRevealEventInit-viewTransition">viewTransition</dfn> = null;
noamr marked this conversation as resolved.
Show resolved Hide resolved
};</code></pre>
noamr marked this conversation as resolved.
Show resolved Hide resolved

noamr marked this conversation as resolved.
Show resolved Hide resolved
<div w-nodev>

<p>The <dfn attribute for="PageRevealEvent"><code
data-x="dom-PageRevealEvent-viewTransition">viewTransition</code></dfn> attribute getter steps
domenic marked this conversation as resolved.
Show resolved Hide resolved
are:

<ol>
<li><p>Let <var>viewTransition</var> be <span>this</span>'s <span>relevant global object</span>'s
<span>active document</span>'s <span>active view transition</span>.</p></li>

noamr marked this conversation as resolved.
Show resolved Hide resolved
<li><p>If <var>viewTransition</var> is non-null and its
<span>is inbound cross-document view-transition</span> is true, then return <var>viewTransition</var>;
Otherwise return null.</p></li>
noamr marked this conversation as resolved.
Show resolved Hide resolved
</ol>

</div>
domenic marked this conversation as resolved.
Show resolved Hide resolved


<h5>The <code>BeforeUnloadEvent</code> interface</h5>

<pre><code class="idl">[Exposed=Window]
Expand Down Expand Up @@ -100318,6 +100351,8 @@ location.href = '#foo';</code></pre>
<ol>
<li><p>Set <var>document</var>'s <span>page showing</span> flag to true.</p></li>

<li><p>Set <var>document</var>'s <span>is revealed</span> to false.</p>

<li><p><span>Update the visibility state</span> of <var>document</var> to "<code
data-x="">visible</code>".</p></li>

Expand Down Expand Up @@ -100358,6 +100393,17 @@ location.href = '#foo';</code></pre>
</li>
</ol>

<p>To <dfn>reveal</dfn> a <code>Document</code> <var>document</var>:</p>

<ol>
domenic marked this conversation as resolved.
Show resolved Hide resolved
<li><p>If <var>document</var>'s <span>is revealed</span> is true, then return.

<li><p>Set <var>document</var>'s <span>is revealed</span> to true.

<li><p><span data-x="concept-event-fire">Fire an event</span> named
<code data-x="event-pagereveal">pagereveal</code> at <var>document</var>'s
<span>relevant global object</span>, using <code>PageRevealEvent</code>.</p></li>
</ol>
domenic marked this conversation as resolved.
Show resolved Hide resolved

<h5>Scrolling to a fragment</h5>

Expand Down Expand Up @@ -101400,6 +101446,12 @@ new PaymentRequest(&hellip;); // Allowed to use
data-x="event-pagehide">pagehide</code> events in a row without an intervening <code
data-x="event-pageshow">pageshow</code>, or vice versa).</p>

<p>A <code>Document</code> has a boolean <dfn>is revealed</dfn>, initially false. The
<span>is revealed</span> flag is used to ensure that the
<code data-x="event-pagereveal">pagereveal</code> event is fired once for each activation of the
<code>Document</code> (once when it's rendered initially, and once for each
<span data-x="reactivate a document">reactivation</span>).</p>

<p>A <code>Document</code> has a <code>DOMHighResTimeStamp</code> <dfn>suspension time</dfn>,
initially 0.</p>

Expand Down Expand Up @@ -107010,6 +107062,9 @@ import "https://example.com/foo/../module2.mjs";</code></pre>
</div>
</li>

<li><p>For each <span>fully active</span> <code>Document</code> in <var>docs</var>,
<span>reveal</span> that <code>Document</code>.</p></li>

<li><p>For each <span>fully active</span> <code>Document</code> in <var>docs</var>, <span>flush
autofocus candidates</span> for that <code>Document</code> if its <span>node navigable</span>
is a <span>top-level traversable</span>.</p></li>
Expand Down Expand Up @@ -108744,6 +108799,7 @@ typedef <span>OnBeforeUnloadEventHandlerNonNull</span>? <dfn typedef>OnBeforeUnl
<tr><td><dfn attribute for="WindowEventHandlers"><code data-x="handler-window-onoffline">onoffline</code></dfn> <td> <code data-x="event-offline">offline</code> <!-- new -->
<tr><td><dfn attribute for="WindowEventHandlers"><code data-x="handler-window-ononline">ononline</code></dfn> <td> <code data-x="event-online">online</code> <!-- new -->
<tr><td><dfn attribute for="WindowEventHandlers"><code data-x="handler-window-onpagehide">onpagehide</code></dfn> <td> <code data-x="event-pagehide">pagehide</code> <!-- new -->
<tr><td><dfn attribute for="WindowEventHandlers"><code data-x="handler-window-onpagereveal">onpagereveal</code></dfn> <td> <code data-x="event-pagereveal">pagereveal</code> <!-- new -->
<tr><td><dfn attribute for="WindowEventHandlers"><code data-x="handler-window-onpageshow">onpageshow</code></dfn> <td> <code data-x="event-pageshow">pageshow</code> <!-- new -->
<tr><td><dfn attribute for="WindowEventHandlers"><code data-x="handler-window-onpopstate">onpopstate</code></dfn> <td> <code data-x="event-popstate">popstate</code> <!-- new -->
<tr><td><dfn attribute for="WindowEventHandlers"><code data-x="handler-window-onrejectionhandled">onrejectionhandled</code></dfn> <td> <code data-x="event-rejectionhandled">rejectionhandled</code>
Expand Down Expand Up @@ -137752,6 +137808,12 @@ interface <dfn interface>External</dfn> {
<td> <code data-x="event-pagehide">pagehide</code> event handler for <code>Window</code> object
<td> <span data-x="event handler content attributes">Event handler content attribute</span>

<tr>
<th id="ix-handler-window-onpagereveal"> <code data-x="">onpagereveal</code>
<td> <code data-x="handler-window-onpagereveal">body</code>
<td> <code data-x="event-pagereveal">pagereveal</code> event handler for <code>Window</code> object
<td> <span data-x="event handler content attributes">Event handler content attribute</span>

<tr>
<th id="ix-handler-window-onpageshow"> <code data-x="">onpageshow</code>
<td> <code data-x="handler-window-onpageshow">body</code>
Expand Down Expand Up @@ -138622,6 +138684,13 @@ INSERT INTERFACES HERE
<td> Fired at the <code>Window</code> when the page's <span>session history entry</span> stops
being the <span data-x="nav-active-history-entry">active entry</span>

<tr> <!-- pagereveal -->
<td> <dfn event for="Window"><code data-x="event-pagereveal">pagereveal</code></dfn>
<td> <code>PageRevealEvent</code>
<td> <code>Window</code>
<td> Fired at the <code>Window</code> when the page begins to render, for the first time after
it has been initialized or <span data-x="reactivate a document">reactivated</span>.
noamr marked this conversation as resolved.
Show resolved Hide resolved

<tr> <!-- pageshow -->
<td> <dfn event for="Window"><code data-x="event-pageshow">pageshow</code></dfn>
<td> <code>PageTransitionEvent</code>
Expand Down