К основному содержанию
правило CX Codex

client-passive-event-listeners — правило для Claude Code

Правило client-passive-event-listeners учит агента добавлять { passive: true } к обработчикам событий скролла и тача, чтобы браузер не задерживал прокрутку страницы.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/client-passive-event-listeners.md
Открыть на GitHub

Что делает client-passive-event-listeners

Правило инструктирует ассистента передавать флаг { passive: true } в вызовы addEventListener для событий touchstart и wheel. Без этого параметра браузер вынужден ожидать завершения функции, чтобы проверить, не вызван ли метод preventDefault(). В результате возникает ощутимая задержка при прокрутке экрана.

Инструкция разделяет сценарии использования. Пассивные слушатели нужны для систем аналитики, логирования и любых обработчиков, которым не требуется отменять стандартное поведение. Если же компонент реализует собственные жесты свайпа или кастомный зум с вызовом preventDefault(), флаг passive использовать нельзя.

Какие задачи решает

  • устранить задержку прокрутки страницы при обработке событий касания и колеса мыши
  • передать флаг { passive: true } в слушатели аналитики и трекинга действий пользователя
  • разделить обработчики жестов, требующие вызова preventDefault(), и пассивные слушатели
  • оптимизировать реакцию интерфейса на события wheel и touchstart в хуках React

Примеры запросов агенту

  • Проверь хук скролла в компоненте ленты и добавь { passive: true } во все обработчики событий wheel
  • Настрой отслеживание координат касания экрана в useEffect, исключив блокировку скролла браузера
  • Отрефактори подписки на события touchstart в модуле аналитики без отмены поведения по умолчанию

Как установить client-passive-event-listeners

Вручную: положить файлы

.claude/rules/client-passive-event-listeners.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о client-passive-event-listeners

Как установить client-passive-event-listeners в Claude Code?

Сохраните файл правила по пути .claude/rules/client-passive-event-listeners.md в корне вашего проекта.

Что делает правило client-passive-event-listeners?

Оно предписывает ассистенту использовать флаг { passive: true } при регистрации слушателей wheel и touchstart, устраняя задержку скролла.

Когда нельзя использовать пассивные слушатели событий?

Флаг passive нельзя ставить в обработчиках, вызывающих preventDefault(), например при создании кастомных жестов свайпа или зума.

Исходный текст

client-passive-event-listeners.md · MIT
---
title: Use Passive Event Listeners for Scrolling Performance
impact: MEDIUM
impactDescription: eliminates scroll delay caused by event listeners
tags: client, event-listeners, scrolling, performance, touch, wheel
---

## Use Passive Event Listeners for Scrolling Performance

Add `{ passive: true }` to touch and wheel event listeners to enable immediate scrolling. Browsers normally wait for listeners to finish to check if `preventDefault()` is called, causing scroll delay.

**Incorrect:**

```typescript
useEffect(() => {
  const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
  const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
  
  document.addEventListener('touchstart', handleTouch)
  document.addEventListener('wheel', handleWheel)
  
  return () => {
    document.removeEventListener('touchstart', handleTouch)
    document.removeEventListener('wheel', handleWheel)
  }
}, [])
```

**Correct:**

```typescript
useEffect(() => {
  const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
  const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
  
  document.addEventListener('touchstart', handleTouch, { passive: true })
  document.addEventListener('wheel', handleWheel, { passive: true })
  
  return () => {
    document.removeEventListener('touchstart', handleTouch)
    document.removeEventListener('wheel', handleWheel)
  }
}, [])
```

**Use passive when:** tracking/analytics, logging, any listener that doesn't call `preventDefault()`.

**Don't use passive when:** implementing custom swipe gestures, custom zoom controls, or any listener that needs `preventDefault()`.

© tech-leads-club · MIT · tech-leads-club/agent-skills

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
client-side-rendering patterns.dev Скилл client-side-rendering для Claude Code и других ИИ-агентов, который встраивает в код паттерны клиентского рендеринга для React. Активируется на файлах *.tsx и *.jsx, когда агенту нужно построить интерактивное SPA. CX Codex +1 1 100установок js-performance-patterns patterns.dev Скилл js-performance-patterns для Claude Code помогает устранять просадки скорости в горячих путях JavaScript: в циклах, обработчиках событий и операциях с DOM. CX Codex +1 716установок frontend-js-best-practices sergiodxa Скилл frontend-js-best-practices задаёт 17 правил оптимизации и стиля для JavaScript и TypeScript. Помогает писать быстрые циклы, избегать лишних аллокаций и убирать мутации массивов при рефакторинге. CX Codex +1 341установок apollo-client sanjeed5 Задаёт стандарты Apollo Client 3.x для React: синглтон клиента, хуки вместо императивных вызовов и работу с InMemoryCache. CX Codex +1 ★ 3 589звёзд репо event-landing-page Samuel Berthe Скилл event-landing-page собирает публичную страницу конференции, митапа или хакатона: секции, кнопки по датам, доступность и разметку события. CX Codex +1 6 800установок js-min-max-loop jarrodwatts Правило js-min-max-loop требует искать минимум и максимум в массиве одним циклом вместо сортировки. Помогает избежать вычислений O(n log n) и лишнего копирования данных. CX Codex +1 ★ 1 064звёзд репо

Из того же набора130

Весь набор →
server-cache-lru Правило Claude Code server-cache-lru объясняет, когда заменить React.cache() на LRU-кэш между запросами. Показывает повторное использование общих данных в последовательных запросах. CX Codex +1 ★ 7 191звёзд репо advanced-event-handler-refs Правило advanced-event-handler-refs учит Claude Code сохранять колбэки в useRef или useEffectEvent внутри хуков эффектов, чтобы подписки на события не пересоздавались при каждом рендере. CX Codex +1 ★ 7 191звёзд репо server-parallel-fetching Правило server-parallel-fetching для Claude Code показывает, как перестроить React Server Components для параллельных независимых запросов данных. Устраняет цепочки загрузки, где компонент ждёт другого. CX Codex +1 ★ 7 191звёзд репо _sections Правило _sections для Claude Code, которое определяет восемь разделов оптимизации производительности, их приоритеты и порядок применения. Устанавливается один раз в проект и служит справочником при анализе кода агентом. CX Codex +1 ★ 7 191звёзд репо js-cache-storage Правило js-cache-storage требует держать значения localStorage, sessionStorage и cookie в памяти, а не дёргать синхронное хранилище на каждом вызове. CX Codex +1 ★ 7 191звёзд репо rerender-use-ref-transient-values Правило rerender-use-ref-transient-values учит агента хранить часто меняющиеся значения в useRef, а не в useState, чтобы избежать перерисовок компонента на каждое обновление. CX Codex +1 ★ 7 191звёзд репо js-length-check-first Правило js-length-check-first для Claude Code, которое подсказывает проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, массивы точно не равны — операция не нужна. CX Codex +1 ★ 7 191звёзд репо js-tosorted-immutable Правило js-tosorted-immutable заменяет мутирующий .sort() на .toSorted(), чтобы сортировка не меняла массивы в props и state React. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой