Event.stopPropagation()
The stopPropagation()
method of the Event
interface prevents further propagation of the current event in the capturing and bubbling phases. It does not, however, prevent any default behaviors from occurring; for instance, clicks on links are still processed. If you want to stop those behaviors, see the preventDefault()
method. It also does not prevent immediate propagation to other event-handlers. If you want to stop those, see stopImmediatePropagation()
.
Syntax
event.stopPropagation();
Parameters
None.
Return value
undefined
.
Examples
See Example 5: Event Propagation in the Examples chapter for a more detailed example of this method and event propagation in the DOM.
Specifications
Specification |
---|
DOM Standard (DOM) # ref-for-dom-event-stoppropagation① |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
stopPropagation |
1 |
12 |
1 |
9 |
7 |
1 |
1 |
18 |
4 |
10.1 |
1 |
1.0 |
See also
- See the DOM specification for the explanation of event flow. The DOM Level 3 Events draft has an illustration.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Event/stopPropagation