JavaScript метод Event.stopPropagation()
Определение и применение
JavaScript метод stopPropagation() объекта
Event
прекращает дальнейшую передачу текущего события (предотвращает всплытие по дереву DOM).
Остановка действует на дальнейшее распространение как в фазе перехвата, так и при всплытии. Она не отменяет действие
по умолчанию; для этого используется preventDefault().
Поддержка браузерами
Спецификация: dom.spec.whatwg
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
stopPropagation | 1 | 12 | 1 | 7 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 | 1 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
JavaScript синтаксис
event.stopPropagation();
Спецификация
Пример использования
Остановка всплытия через stopPropagation()
Нажмите и кликните по вложенному блоку: в консоли появятся сообщения DIV 1 и DIV 2. Отметьте флажок и кликните снова — событие не всплывёт, и сработает только обработчик вложенного блока.
index.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
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
.container {
height: 100px;
padding: 30px;
background: plum;
}
div > div {
height: 70px;
background: yellow;
}
Нажмите , чтобы запустить пример.
В этом примере мы разместили два элемента
<div>, один из которых вложили во внутрь другого, с использованием метода
addEventListener()
назначили обработчики события "click" (нажатие левой кнопкой мыши на элементе). Если при снятой галочке
элемента
<input>
произвести нажатие по вложенному элементу, то произойдет вызов двух обработчиков события, так как событие будет
распространяться вверх по дереву DOM.
А, если мы поставим галочку на элементе
<input>
и произведем нажатие по вложенному элементу, то в этом случае сработает только обработчик вложенного элемента. Это
связано с тем, что мы используем метод stopPropagation() объекта
Event, который прекращает дальнейшую передачу текущего события (предотвращает всплытие по дереву DOM).