События в 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
| Поведение | Нативный DOM | React |
|---|---|---|
onChange у <input> | change — после потери фокуса | На каждый ввод (по сути, input) |
onFocus / onBlur | focus/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