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

Jump to bottom

Event constructor issue 223 #426

Closed
wants to merge 2 commits into from
Closed

Event constructor issue 223 #426

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ea15c00
Tweak the definition of coalesced event list to deal with untrusted e…
Jul 7, 2021
b59f658
Fix for https://github.com/w3c/pointerevents/issues/223, specify even…
Dec 22, 2021
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
19 changes: 13 additions & 6 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -322,7 +322,11 @@ <h2><code>PointerEvent</code> Interface</h2>
</dd>
</dl>

<p>The <dfn>PointerEventInit</dfn> dictionary is used by the <dfn>PointerEvent</dfn> interface's constructor to provide a mechanism by which to construct untrusted (synthetic) pointer events. It inherits from the {{MouseEventInit}} dictionary defined in [[UIEVENTS]]. The [=event constructing steps=] are defined in the [[[DOM]]]. See the <a href="#examples" title="examples">examples</a> for sample code demonstrating how to fire an untrusted pointer event.</p>
<p>The <dfn>PointerEventInit</dfn> dictionary is used by the <dfn>PointerEvent</dfn> interface's constructor to provide a mechanism by which to construct untrusted (synthetic) pointer events. It inherits from the {{MouseEventInit}} dictionary defined in [[UIEVENTS]]. See the <a href="#examples" title="examples">examples</a> for sample code demonstrating how to fire an untrusted pointer event.</p>

<p>The [=event constructing steps=] for <dfn>PointerEvent</dfn>
clones <a>PointerEventInit</a>'s <code>coalescedEvents</code> to <a>coalesced event list</a> and
clones <a>PointerEventInit</a>'s <code>predictedEvents</code> to <a>predicted event list</a>.</p>

<div class="note">
<p>Pointer Events include two complementary sets of attributes to express the orientation of a
Expand Down Expand Up @@ -963,11 +967,13 @@ <h2><dfn>Coalesced events</dfn></h2>
</figure>

<p>A <a>PointerEvent</a> has an associated <dfn>coalesced event list</dfn> (a list of
zero or more <code>PointerEvent</code>s). If this event is a <code>pointermove</code>
or <code>pointerrawupdate</code> event, the list is a sequence of all <code>PointerEvent</code>s
that were coalesced into this event; otherwise it is an empty list.</p>
zero or more <code>PointerEvent</code>s). If a trusted event is a <code>pointermove</code> or
<code>pointerrawupdate</code> event, the list is a sequence of all <code>PointerEvent</code>s
that were coalesced into this event; otherwise it is an empty list.
Untrusted events have their <a>coalesced event list</a> initialized to the value passed to the
constructor.</p>

<p>The events in the coalesced event list will have increasing
<p>The events in the coalesced event list of a trusted event will have increasing
{{Event/timeStamp}}s, so the first event will have the smallest {{Event/timeStamp}}.</p>

<pre id="example_10" class="example" title="Basic canvas drawing application using the coalesced events list">
Expand Down Expand Up @@ -1059,7 +1065,8 @@ <h2><dfn>Predicted events</dfn></h2>
<p>A <a>PointerEvent</a> has an associated <dfn>predicted event list</dfn> (a list of zero or more
<code>PointerEvent</code>s). If this event is a <code>pointermove</code> event, it is a sequence of
<code>PointerEvent</code>s that the user agent predicts will follow the events in the
<a>coalesced event list</a> in the future; otherwise it is an empty list.</p>
<a>coalesced event list</a> in the future; otherwise it is an empty list.
Untrusted events have their predicted event list initialized to the value passed to the constructor.</p>
<div class="note">
<p>While <code>pointerrawmove</code> events may have a non-empty <a>coalesced event list</a>,
their <a>predicted event list</a> will, for performance reasons, usually be an empty list.</p>
Expand Down