Делегирование событий в JavaScriptодин обработчик на контейнере, closest() и события без всплытия
Вешать обработчик на каждую кнопку списка неудобно и дорого. Делегирование обходится одним слушателем на контейнере, но спотыкается о focus, mouseenter и Shadow DOM.
- Раздел
- JavaScript
- Стек
- JavaScriptDOMWeb Components
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- Всплытие позволяет обслужить весь список одним обработчиком.
- closest() находит нужный элемент от любой вложенной цели.
- Вместо focus и blur слушайте focusin и focusout.
- Из Shadow DOM настоящую цель покажет composedPath().
- Повесьте один обработчик на ближайший общий контейнер
- Найдите элемент через event.target.closest(селектор)
- Проверьте, что найденный элемент внутри контейнера
- Для фокуса используйте focusin и focusout
- Снимайте слушатели через AbortController и signal
Один обработчик вместо сотни#
Представьте список задач, где у каждой строки есть кнопка «Удалить». Первое решение: пройти циклом по всем кнопкам и повесить на каждую обработчик. Оно работает, пока список статичен. Как только строки начинают добавляться через JavaScript, новые кнопки остаются глухими, и приходится не забывать вешать обработчики после каждой вставки. При тысяче строк растёт и расход памяти.
Делегирование событий решает это иначе. Большинство событий в DOM всплывают: клик по кнопке сначала обрабатывается на самой кнопке, затем на её родителе, затем выше, вплоть до document и window. Значит, достаточно одного обработчика на общем контейнере. В нём мы смотрим на event.target, то есть на элемент, по которому реально кликнули, и решаем, что делать.
<ul id="todo">
<li data-id="1">Купить хлеб <button class="remove">Удалить</button></li>
<li data-id="2">Позвонить <button class="remove">Удалить</button></li>
</ul>У такого подхода три плюса: обработчик один, элементы, добавленные позже, работают без дополнительного кода, а при удалении строки не нужно ничего отписывать. Тот же принцип, кстати, был во Flash: события MouseEvent всплывали по дисплейному списку, подробнее об этом в заметке о собственных событиях в AS3.
Как это выглядело во времена IE8#
В Internet Explorer до девятой версии не было addEventListener. Вместо него использовали attachEvent с префиксом on, объект события брали из window.event, а цель лежала в свойстве srcElement, а не в target. Метода closest() тоже не было, поэтому подъём от цели к нужному элементу писали циклом по parentNode.
// 2011: кроссбраузерное делегирование с поддержкой IE8
function addEvent(el, type, handler) {
if (el.addEventListener) {
el.addEventListener(type, handler, false);
} else {
el.attachEvent('on' + type, function () {
handler.call(el, window.event);
});
}
}
var list = document.getElementById('todo');
addEvent(list, 'click', function (e) {
var target = e.target || e.srcElement;
// поднимаемся от цели к контейнеру в поисках кнопки
while (target && target !== list) {
if (target.nodeName === 'BUTTON' &&
(' ' + target.className + ' ').indexOf(' remove ') > -1) {
var item = target.parentNode;
item.parentNode.removeChild(item);
return;
}
target = target.parentNode;
}
});Ещё одна деталь эпохи: внутри обработчика attachEvent ключевое слово this указывало на window, а не на элемент, отсюда handler.call(el, ...) в обёртке. Многие тогда не писали это руками, а брали jQuery: метод .live(), затем .delegate(), а с версии 1.7 универсальный .on(событие, селектор, обработчик). Внутри это было то же самое делегирование.
Современный вариант: closest() и проверка границ#
Сегодня цикл заменяет одна строка. Метод Element.closest(селектор) проверяет сам элемент и его предков и возвращает первый подходящий или null. Это важно, потому что event.target часто оказывается не кнопкой, а иконкой svg или span внутри неё.
const list = document.querySelector('#todo');
const controller = new AbortController();
list.addEventListener('click', (event) => {
if (!(event.target instanceof Element)) return;
const button = event.target.closest('button.remove');
if (!button || !list.contains(button)) return;
const item = button.closest('li');
removeTodo(item.dataset.id);
item.remove();
}, { signal: controller.signal });
// снять все обработчики виджета разом
// controller.abort();Разберём проверки, которые легко пропустить.
instanceof Elementзащищает от целей, у которых нетclosest(), например когда событие сгенерировано наdocument.list.contains(button)нужен, если контейнеры вложены:closest()может подняться выше контейнера и найти совпадение снаружи.- Данные строки удобнее держать в
data-атрибутах и читать черезdataset, а не вычислять по индексу в DOM. - Если внутри интерактивного элемента лежат другие кнопки, решайте явно, какой из них обработчик должен отдать приоритет.
Делегирование хорошо сочетается с debounce на тех же контейнерах: например, одно событие input на форме обслуживает все поля, а запрос отправляется после паузы. Об этом подробно в заметке про debounce и throttle.
События, которые не всплывают#
Делегирование держится на всплытии, поэтому с событиями, которые не всплывают, оно не работает в лоб. Самые частые случаи собраны в таблице.
| Не всплывает | Чем заменить при делегировании |
|---|---|
focus, blur | focusin, focusout |
mouseenter, mouseleave | mouseover, mouseout с проверкой relatedTarget |
pointerenter, pointerleave | pointerover, pointerout |
load, error у картинок | слушатель в фазе перехвата: третий аргумент true или { capture: true } |
const form = document.querySelector('#signup');
// focus и blur не всплывают, focusin и focusout всплывают
form.addEventListener('focusin', (e) => {
e.target.closest('.field')?.classList.add('is-active');
});
form.addEventListener('focusout', (e) => {
e.target.closest('.field')?.classList.remove('is-active');
});
// mouseenter не всплывает: эмулируем через mouseover и relatedTarget
list.addEventListener('mouseover', (e) => {
const row = e.target.closest('li');
if (!row || row.contains(e.relatedTarget)) return;
showPreview(row.dataset.id);
});Проверка row.contains(e.relatedTarget) отсекает переходы курсора между дочерними элементами одной строки: mouseover срабатывает на каждом из них, а нам нужен только вход в строку снаружи. Для чисто визуальной подсветки при наведении или фокусе JavaScript не нужен вовсе: псевдоклассы :hover и :focus-within справляются сами, подробнее в разделе CSS.
Что изменилось к 2026 году#
Базовая идея осталась прежней, но инструменты стали проще и появились новые границы, которые надо учитывать.
- closest() и matches() есть во всех актуальных браузерах, полифилы для них в новых проектах не нужны.
- Опция signal в
addEventListenerпозволяет снять все слушатели виджета однимabort(), не храня ссылки на функции. - Shadow DOM меняет target. Когда событие выходит из теневого дерева компонента, браузер подменяет
targetна сам хост-элемент. Полный путь до реальной цели возвращаетevent.composedPath()(для закрытых shadow root внутренности в нём скрыты). - Собственные события компонента покидают shadow root, только если созданы с
composed: true, а до внешнего контейнера дойдут только сbubbles: true.
class TodoList extends HTMLElement {
#controller = new AbortController();
connectedCallback() {
const root = this.shadowRoot ?? this.attachShadow({ mode: 'open' });
root.innerHTML = '<ul><slot></slot></ul>';
// делегируем внутри собственного shadow root
root.addEventListener('click', (e) => {
const btn = e.target.closest?.('button.remove');
btn?.closest('li')?.remove();
}, { signal: this.#controller.signal });
}
disconnectedCallback() {
this.#controller.abort();
}
}
customElements.define('todo-list', TodoList);
// снаружи: target указывает на хост, полный путь даёт composedPath()
document.addEventListener('click', (e) => {
const btn = e.composedPath().find(
(node) => node instanceof Element && node.matches('button.remove')
);
if (btn) console.log('клик по кнопке внутри компонента', btn);
});Внутри компонента удобнее всего делегировать на собственном shadow root: там target ещё не подменён. Снаружи используйте composedPath(), если действительно нужно знать, что происходит внутри чужого компонента; чаще правильнее, чтобы компонент сам отправил понятное событие вроде todo-remove.
Делегирование и доступность#
Делегирование часто соблазняет сделать кликабельной любую строку: повесить обработчик на список и ловить клики по li или div. Мышью это работает, но с клавиатуры такой элемент недоступен: на него нельзя перейти табом, а Enter и пробел ничего не делают. Скринридер тоже не объявит его как кнопку.
Правильный путь: внутри строки должен быть настоящий интерактивный элемент, button для действия или a для перехода. Тогда браузер сам превращает нажатие Enter или пробела на кнопке в событие click, и делегированный обработчик получает его так же, как клик мышью. Отдельные слушатели keydown для этого не нужны. Если же строка целиком должна вести на страницу, растяните ссылку внутри неё на весь блок средствами CSS, а не обрабатывайте клики по строке.
Отдельная ловушка: event.stopPropagation() во вложенном обработчике. Он останавливает всплытие, и делегированный слушатель на контейнере перестаёт получать событие. Если какой-то сторонний виджет внутри списка гасит всплытие, ваш код молча перестанет работать. Используйте stopPropagation() только там, где без него нельзя, и оставляйте рядом комментарий почему.
Когда делегирование не нужно#
Не стоит вешать всё подряд на document. Обработчик на самом верху вызывается на каждый клик по странице и проверяет селекторы впустую, а при отладке трудно понять, кто отвечает за поведение. Разумная граница: ближайший общий контейнер виджета. Если элемент один и не пересоздаётся, обычный обработчик на нём проще и понятнее. Фреймворки вроде React сами используют делегирование на корне приложения, так что в JSX руками его повторять не нужно. Ещё больше практики по событиям и DOM ищите в разделе JavaScript.
«Слушайте событие там, где живёт список, а не там, где живёт каждая кнопка.»
Главный вывод заметки


