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 11 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
84 changes: 84 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/#activate-view-transition">activate 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"><code>ViewTransition</code></dfn></li>
<li><dfn data-x-href="https://drafts.csswg.org/css-view-transitions-2/#document-resolve-cross-document-view-transition">resolve 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,42 @@ 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="PageRevealEventInit" 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
<dl class="domintro">
<dt><code data-x=""><var>event</var>.<span subdfn data-x="dom-PageRevealEvent-viewTransition">viewTransition</span></code></dt>
<dd>
<p>For the <code data-x="event-pagereveal">pagereveal</code> event, returns the
domenic marked this conversation as resolved.
Show resolved Hide resolved
<code>ViewTransition</code> object that represents an inbound cross-document view transition, if
such transition is active when the event is fired. Otherwise, returns null.</p>
</dd>
</dl>

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

<p>The <dfn attribute for="PageRevealEvent"><code
data-x="dom-PageRevealEvent-viewTransition">viewTransition</code></dfn> attribute must return the
noamr marked this conversation as resolved.
Show resolved Hide resolved
value it was initialized to.</p>

<p class="note">Though <code data-x="event-pagereveal">pagereveal</code> is guaranteed to be fired
domenic marked this conversation as resolved.
Show resolved Hide resolved
during the first <span>update the rendering</span> step that displays an up-to-date version of the
page, user agents are free to display cached frame of the page before firing it. This prevents the
presence of a <code data-x="event-pagereveal">pagereveal</code> handler from delaying the
presentation of such cached frame.</p>

</div>


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

<pre><code class="idl">[Exposed=Window]
Expand Down Expand Up @@ -100318,6 +100357,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 +100399,25 @@ location.href = '#foo';</code></pre>
</li>
</ol>

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

<ol>
<li><p>If <var>document</var>'s <span>is revealed</span> is true, then return.</p></li>

domenic marked this conversation as resolved.
Show resolved Hide resolved
<li><p>Set <var>document</var>'s <span>is revealed</span> to true.</p></li>

<li><p><span>Resolve cross-document view-transition</span> for <var>document</var> and let
<var>transition</var> be the result.</p></li>

noamr marked this conversation as resolved.
Show resolved Hide resolved
<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> with its <code
data-x="dom-PageRevealEvent-viewTransition">viewTransition</code> set to
<var>transition</var>.</p></li>

<li><p>If <var>transition</var> is not null, then <span
data-x="activate view transition">activate</span> <var>transition</var>.</p></li>
</ol>

<h5>Scrolling to a fragment</h5>

Expand Down Expand Up @@ -101400,6 +101460,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
domenic marked this conversation as resolved.
Show resolved Hide resolved
<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 +107076,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 +108813,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 @@ -108871,6 +108941,7 @@ interface mixin <dfn interface>WindowEventHandlers</dfn> {
attribute <span>EventHandler</span> <span data-x="handler-window-onoffline">onoffline</span>;
attribute <span>EventHandler</span> <span data-x="handler-window-ononline">ononline</span>;
attribute <span>EventHandler</span> <span data-x="handler-window-onpagehide">onpagehide</span>;
attribute <span>EventHandler</span> <span data-x="handler-window-onpagereveal">onpagereveal</span>;
attribute <span>EventHandler</span> <span data-x="handler-window-onpageshow">onpageshow</span>;
attribute <span>EventHandler</span> <span data-x="handler-window-onpopstate">onpopstate</span>;
attribute <span>EventHandler</span> <span data-x="handler-window-onrejectionhandled">onrejectionhandled</span>;
Expand Down Expand Up @@ -137752,6 +137823,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 +138699,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>

noamr marked this conversation as resolved.
Show resolved Hide resolved
<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>.

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