re:re:actable
Урок 144 минуты чтения

События в React: SyntheticEvent, делегирование и фазы

На этой странице
Кратко

React не вешает обработчик на каждый элемент. Он использует делегирование: слушает события на корневом контейнере приложения (с React 17 — на элементе, переданном в createRoot, а не на document) и сам находит, какие обработчики вызвать, проходя по дереву React-компонентов. В обработчик приходит SyntheticEvent — кросс-браузерная обёртка над нативным событием с тем же API (target, currentTarget, preventDefault(), stopPropagation()), оригинал доступен как e.nativeEvent. Обработчики фазы погружения задаются суффиксом Capture (onClickCapture). Важные отличия от DOM: onChange у полей срабатывает на каждый ввод (как нативный input), onFocus/onBlur всплывают, события из порталов всплывают по дереву React, а не DOM. Пулинга событий (event pooling) с React 17 больше нет.

Вопрос

Как устроена обработка событий в React? Что такое SyntheticEvent и делегирование? Чем события React отличаются от нативных?

Основная идея

Пользователь кликнул по <button> внутри <li> внутри <ul>
 
DOM:     событие всплывает до #root
React:   слушатель на #root ловит click
         → находит Fiber-узел кнопки
         → собирает обработчики по пути вверх по дереву компонентов
         → вызывает onClickCapture (сверху вниз), затем onClick (снизу вверх)
         → в каждый передаёт один SyntheticEvent

Почему так:

  • Меньше слушателей: тысяча строк списка не создаёт тысячу addEventListener.
  • Единообразие: React выравнивает различия браузеров.
  • Интеграция с рендером: React знает приоритет события (клик — срочное обновление, mousemove — непрерывное) и планирует обновления состояния соответственно.

Пример: фазы и остановка всплытия

export default function BookList({ books, onOpen }) {
  return (
    <ul
      onClickCapture={() => console.log('1. capture: ul')}
      onClick={() => console.log('4. bubble: ul — открыть список')}
    >
      {books.map(book => (
        <li key={book.id} onClick={() => onOpen(book.id)}>
          {book.title}
          <button
            onClick={(e) => {
              e.stopPropagation(); // клик по кнопке не откроет книгу
              console.log('3. bubble: button — в избранное');
            }}
          >
            ★
          </button>
        </li>
      ))}
    </ul>
  );
}

Клик по ★: capture: ul → button → (дальше всплытие остановлено). Клик по названию: capture: ul → li (onOpen) → ul.

Типичные операции

function SearchForm({ onSearch }) {
  function handleSubmit(e) {
    e.preventDefault(); // не перезагружать страницу
    const data = new FormData(e.currentTarget); // currentTarget — сама форма
    onSearch(String(data.get('q')));
  }
 
  return (
    <form onSubmit={handleSubmit}>
      <input
        name="q"
        onKeyDown={(e) => {
          if (e.key === 'Escape') e.currentTarget.value = '';
        }}
      />
      <button>Найти</button>
    </form>
  );
}
  • e.target — элемент, где событие возникло; e.currentTarget — элемент, чей обработчик сейчас выполняется.
  • e.key вместо устаревших keyCode/which.
  • Передача аргументов: onClick={() => remove(book.id)}, а не onClick={remove(book.id)} — во втором случае функция вызовется при рендере.

Отличия от нативного DOM

ПоведениеНативный DOMReact
onChange у <input>change — после потери фокусаНа каждый ввод (по сути, input)
onFocus / onBlurfocus/blur не всплываютВсплывают (React использует focusin/focusout)
onScrollНе всплываетТоже не всплывает (с React 17)
События в порталеВсплывают по DOMВсплывают по дереву React
return falseВ inline-обработчиках отменяет действиеНичего не делает — нужен preventDefault()
ОбработчикСтрока или функцияТолько функция

Нативные слушатели рядом с React

function useEscape(onEscape) {
  useEffect(() => {
    const handler = (e) => e.key === 'Escape' && onEscape();
    document.addEventListener('keydown', handler);
    return () => document.removeEventListener('keydown', handler); // обязательно cleanup
  }, [onEscape]);
}

Нативные слушатели нужны для window/document (resize, глобальные клавиши), для passive: false (например, отменить wheel при зуме) и для событий, которых нет в React. Помни: e.stopPropagation() в React-обработчике останавливает всплытие и для нативного события, которое ещё не дошло до корня, но слушатели на document выполняются после React-обработчиков корня.

Подсказка

Обработчики onTouchStart, onTouchMove, onWheel React регистрирует как passive — внутри них preventDefault() не сработает. Для отмены скролла жестом используй нативный слушатель с { passive: false }.

Что важно помнить

  • Делегирование на корень — поэтому несколько React-приложений на странице и сторонний код ведут себя предсказуемо (с React 17).
  • SyntheticEvent можно использовать асинхронно — пулинга нет; e.persist() больше не нужен.
  • Не смешивай без необходимости stopPropagation в React и нативные слушатели — порядок вызова легко перепутать.
  • Для доступности кликабельные элементы должны быть <button>/<a>, а не div onClick.

Мини-шпаргалка

Делегирование: один слушатель на root, обход по дереву React
SyntheticEvent: target, currentTarget, preventDefault, stopPropagation, nativeEvent
Capture-фаза: onClickCapture
onChange = на каждый ввод; onFocus/onBlur всплывают
Порталы: всплытие по дереву React
Нет пулинга с React 17

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам