Делегирование событий в JavaScript

Делегирование событий в JavaScriptодин обработчик на контейнере, closest() и события без всплытия

Вешать обработчик на каждую кнопку списка неудобно и дорого. Делегирование обходится одним слушателем на контейнере, но спотыкается о focus, mouseenter и Shadow DOM.

Раздел
JavaScript
Стек
JavaScriptDOMWeb Components
Уровень
Средний
Опубликовано
Обновлено
Чтение
8 мин
Коротко
  • Всплытие позволяет обслужить весь список одним обработчиком.
  • closest() находит нужный элемент от любой вложенной цели.
  • Вместо focus и blur слушайте focusin и focusout.
  • Из Shadow DOM настоящую цель покажет composedPath().
Как решаем
  1. Повесьте один обработчик на ближайший общий контейнер
  2. Найдите элемент через event.target.closest(селектор)
  3. Проверьте, что найденный элемент внутри контейнера
  4. Для фокуса используйте focusin и focusout
  5. Снимайте слушатели через AbortController и signal

Один обработчик вместо сотни#

Представьте список задач, где у каждой строки есть кнопка «Удалить». Первое решение: пройти циклом по всем кнопкам и повесить на каждую обработчик. Оно работает, пока список статичен. Как только строки начинают добавляться через JavaScript, новые кнопки остаются глухими, и приходится не забывать вешать обработчики после каждой вставки. При тысяче строк растёт и расход памяти.

Делегирование событий решает это иначе. Большинство событий в DOM всплывают: клик по кнопке сначала обрабатывается на самой кнопке, затем на её родителе, затем выше, вплоть до document и window. Значит, достаточно одного обработчика на общем контейнере. В нём мы смотрим на event.target, то есть на элемент, по которому реально кликнули, и решаем, что делать.

HTML
<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.

JavaScript
// 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 внутри неё.

JavaScript
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, blurfocusin, focusout
mouseenter, mouseleavemouseover, mouseout с проверкой relatedTarget
pointerenter, pointerleavepointerover, pointerout
load, error у картинокслушатель в фазе перехвата: третий аргумент true или { capture: true }
JavaScript
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.
JavaScript
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.

1обработчик на весь список
focusinвсплывающая замена focus
composedPath()путь события через Shadow DOM

«Слушайте событие там, где живёт список, а не там, где живёт каждая кнопка.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Почему event.target иногда не кнопка, а иконка?
target указывает на самый глубокий элемент под курсором. Если внутри кнопки лежит svg или span, цель будет именно он. Поэтому ищите нужный элемент через event.target.closest('button'), а не сравнивайте target напрямую с кнопкой.
Чем target отличается от currentTarget?
target это элемент, где событие возникло. currentTarget это элемент, на котором сейчас выполняется обработчик, то есть ваш контейнер. При делегировании они почти всегда различаются, и для поиска строки списка нужен именно target.
Можно ли делегировать события submit и change?
Да. В современных браузерах submit, change и input всплывают, поэтому один обработчик на форме или на документе их поймает. Проблемы с всплытием этих событий были в старых версиях Internet Explorer, сейчас это неактуально.
Влияет ли делегирование на производительность?
Обычно положительно: меньше обработчиков и меньше памяти. Минус в том, что слушатель на большом контейнере запускается на каждое событие внутри него. Для click это незаметно, а для mousemove и scroll держите логику обработчика минимальной.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также