JavaScript метод Event.stopPropagation()

Определение и применение

JavaScript метод stopPropagation() объекта Event прекращает дальнейшую передачу текущего события (предотвращает всплытие по дереву DOM).

Остановка действует на дальнейшее распространение как в фазе перехвата, так и при всплытии. Она не отменяет действие по умолчанию; для этого используется preventDefault().

Поддержка браузерами

Спецификация: dom.spec.whatwg

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьapi.Event.stopPropagation
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
stopPropagation✓1✓12✓1✓7✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
event.stopPropagation();

Спецификация

DOM Standard.

Пример использования

Остановка всплытия через stopPropagation()

Нажмите ▶ и кликните по вложенному блоку: в консоли появятся сообщения DIV 1 и DIV 2. Отметьте флажок и кликните снова — событие не всплывёт, и сработает только обработчик вложенного блока.

index.html
HTML
<div class="container" data-migration-click-0="">
  DIV 2
  <div data-migration-click-2="">DIV 1 (click me)</div>
</div>
<label>Stop propagation<input type="checkbox" /></label>
main.js
JavaScript
const myFunc = function (event) {
    alert('DIV 1')
    if (document.querySelector('input').checked) {
        event.stopPropagation()
    }
}

const myFunc2 = function (event) {
    alert('DIV 2')
}

// Обработчики кнопок перенесены из HTML для запуска с CSP без inline-скриптов.
document.querySelector('[data-migration-click-0]').addEventListener('click', function (event) {
    myFunc2()
})
document.querySelector('[data-migration-click-0]').removeAttribute('data-migration-click-0')
document.querySelector('[data-migration-click-2]').addEventListener('click', function (event) {
    myFunc(event)
})
document.querySelector('[data-migration-click-2]').removeAttribute('data-migration-click-2')
style.css
CSS
.container {
    height: 100px;
    padding: 30px;
    background: plum;
}
div > div {
    height: 70px;
    background: yellow;
}

В этом примере мы разместили два элемента <div>, один из которых вложили во внутрь другого, с использованием метода addEventListener() назначили обработчики события "click" (нажатие левой кнопкой мыши на элементе). Если при снятой галочке элемента <input> произвести нажатие по вложенному элементу, то произойдет вызов двух обработчиков события, так как событие будет распространяться вверх по дереву DOM.

А, если мы поставим галочку на элементе <input> и произведем нажатие по вложенному элементу, то в этом случае сработает только обработчик вложенного элемента. Это связано с тем, что мы используем метод stopPropagation() объекта Event, который прекращает дальнейшую передачу текущего события (предотвращает всплытие по дереву DOM).