You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
When the <var>passive</var> member is set to true, it indicates that the listener’s <b>callback</b> will not cancel the event by invoking <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code>.
690
+
When the <var>passive</var> member is set to true, it indicates that the listener
691
+
is <dfn data-dfn-for="event listener" data-dfn-type="dfn" data-export="" id="concept-passive-event-listener">passive<a class="self-link" href="#concept-passive-event-listener"></a></dfn> in that it’s <b>callback</b> will not cancel the event by invoking <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code>.
691
692
Invoking <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code> from within such a <b>callback</b> will have no effect.
692
693
<p class="note no-backref" role="note"> Setting <b>passive</b> to true can enable the user agent to perform performance
693
694
optimizations described in <a href="#observing-event-listeners">§3.8 Observing event listeners</a>. </p>
In general, developers don’t expect the presence of an event listener to be
771
-
observable. The impact of an event listener is determined by it’s callback.
772
-
That is, a developer adding a no-op event listener would not expect it to have
771
+
In general, developers do not expect the presence of an <a data-link-type="dfn" href="#concept-event-listener">event listener</a> to be
772
+
observable. The impact of an <a data-link-type="dfn" href="#concept-event-listener">event listener</a> is determined by its <b>callback</b>.
773
+
That is, a developer adding a no-op <a data-link-type="dfn" href="#concept-event-listener">event listener</a> would not expect it to have
773
774
any side effects.
774
775
<p>Unfortunately, some event APIs have been designed such that implementing them
775
-
efficiently requires observing event listeners. For example, sensor APIs which
776
+
efficiently requires observing <a data-link-type="dfn" href="#concept-event-listener">event listeners</a>. For example, sensor APIs which
776
777
enable an underlying device sensor, and touch APIs which can be used to block
777
-
async scrolling. In some cases this problem can be mitigated by specifying
778
+
asynchronous scrolling. In some cases this problem can be mitigated by specifying
778
779
the event to be <code class="idl"><a data-link-type="idl" href="#dom-event-cancelable">cancelable</a></code> only when there is at least one
779
-
non-<code class="idl"><a data-link-type="idl" href="#dom-eventlisteneroptions-passive">passive</a></code> listener. For example, non-passive <code class="idl"><a data-link-type="idl" href="http://www.w3.org/TR/touch-events/#touchevent-interface">TouchEvent</a></code> listeners must block scrolling, but if all listeners are passive then
780
-
scrolling can be allowed to start asynchronously by making the <code class="idl"><a data-link-type="idl" href="http://www.w3.org/TR/touch-events/#touchevent-interface">TouchEvent</a></code> uncancelable (so that calls to <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code> are ignored).
781
-
New event types should be defined such that they don’t need this
780
+
non-<a data-link-type="dfn" href="#concept-passive-event-listener">passive</a> listener. For example, non-passive <code class="idl"><a data-link-type="idl" href="http://www.w3.org/TR/touch-events/#touchevent-interface">TouchEvent</a></code> listeners must block scrolling, but if all listeners are passive then
781
+
scrolling can be allowed to start <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/infrastructure.html#in-parallel">in parallel</a> by making the <code class="idl"><a data-link-type="idl" href="http://www.w3.org/TR/touch-events/#touchevent-interface">TouchEvent</a></code> uncancelable (so that calls to <code class="idl"><a data-link-type="idl" href="#dom-event-preventdefault">preventDefault()</a></code> are ignored).
782
+
Ideally, any new event types are defined such that they don’t need this
782
783
property (use <a href="https://lists.w3.org/Archives/Public/public-script-coord/">[email protected]</a> for discussion).</p>
<p>To <dfn data-dfn-for="Event" data-dfn-type="dfn" data-export="" id="concept-event-dispatch">dispatch<a class="self-link" href="#concept-event-dispatch"></a></dfn> an <a data-link-type="dfn" href="#concept-event">event</a> to a
0 commit comments