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.

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 clarification about coalesced events and secure/non secure context #480

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
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
9 changes: 7 additions & 2 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1123,14 +1123,19 @@ <h2><dfn>Coalesced events</dfn></h2>

<p>A <a>PointerEvent</a> has an associated <dfn>coalesced events list</dfn> (a list of
zero or more <code>PointerEvent</code>s). For trusted {{GlobalEventHandlers/pointermove}} and
{{GlobalEventHandlers/pointerrawupdate}} events, the list is a sequence of all <code>PointerEvent</code>s
that were coalesced into this event. The "parent" trusted {{GlobalEventHandlers/pointermove}} and
{{GlobalEventHandlers/pointerrawupdate}} events within a [=secure context=] the list is a sequence
of all <code>PointerEvent</code>s that were coalesced into this event.
The "parent" trusted {{GlobalEventHandlers/pointermove}} and
{{GlobalEventHandlers/pointerrawupdate}} event represents an accumulation of these coalesced events,
but may have additional processing (for example to align with the display refresh rate).
As a result, the coalesced events lists for these events always contain at least one event.
In a [=non secure context=], the coalesced events list contains the a copy of the "parent" event itself,
for compatibility.
For all other trusted event types, it is an empty list. Untrusted events have their
<a>coalesced events list</a> initialized to the value passed to the constructor.</p>

<p></p>

<div class="note">Since a trusted parent event is a summary or aggregation of the
coalesced events, developers should only need to process either the parent events
or all of the coalesced events, but not both.
Expand Down
Loading