# js-batch-dom-css

Правило js-batch-dom-css запрещает чередовать чтение геометрии DOM с записью стилей. Защищает код от синхронного reflow и просадок FPS при анимациях.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 7191 у репозитория
- Автор: tech-leads-club
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(quality)/react-best-practices/rules/js-batch-dom-css.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/js-batch-dom-css

## Что делает

Правило инструктирует ассистента группировать операции с DOM. Когда в коде вызов `offsetWidth`, `offsetHeight` или `getBoundingClientRect()` стоит между сменами `element.style`, браузер вынужден мгновенно пересчитывать разметку страницы.

В инструкциях задан понятный порядок: сначала выполнять фазу чтения геометрии, затем фазу записи, либо наоборот. Для React-компонентов правило требует переключать готовые CSS-классы через `className`, а не менять стили напрямую в `useEffect`.

Позиция: инлайн-стили в кодовой базе не запрещены полностью, но правило явно предписывает заменять их классами везде, где это возможно.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/js-batch-dom-css.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/js-batch-dom-css.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/js-batch-dom-css.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/js-batch-dom-css.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/js-batch-dom-css.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(quality)/react-best-practices/rules/js-batch-dom-css.md

## Когда брать
- устранить layout thrashing при частых манипуляциях с DOM
- разделить чтение геометрии и запись стилей на отдельные фазы
- заменить прямые мутации `element.style` на переключение CSS-классов
- убрать лишние перерисовки внутри хуков `useEffect`

## Примеры запросов агенту
- Проверь этот компонент на вызовы, вызывающие принудительный reflow
- Перепиши функцию анимации так, чтобы чтение размеров шло отдельно от изменения стилей
- Оптимизируй обновление стилей карточки через переключение CSS-классов

## Похожие
- [inspecting-hermes-desktop-dom](https://affpapa.org/nevibecode/skills/inspecting-hermes-desktop-dom.md) — скилл · 263 установки
- [expo-dom](https://affpapa.org/nevibecode/skills/expo-dom.md) — скилл · 25700 установок
- [measuring-dom-nodes](https://affpapa.org/nevibecode/rules/measuring-dom-nodes.md) — правило · ★ 849 у репозитория
- [js-performance-patterns](https://affpapa.org/nevibecode/skills/js-performance-patterns.md) — скилл · 716 установок
- [pixijs-scene-dom-container](https://affpapa.org/nevibecode/skills/pixijs-scene-dom-container.md) — скилл · 6900 установок
- [view-transitions](https://affpapa.org/nevibecode/skills/view-transitions.md) — скилл · 707 установок

## Другие версии с тем же именем
- [js-batch-dom-css · jarrodwatts](https://affpapa.org/nevibecode/rules/jarrodwatts-js-batch-dom-css.md) — ★ 1064 у репозитория

Из того же набора: [tech-leads-club/agent-skills](https://affpapa.org/nevibecode/by/tech-leads-club/agent-skills.md) — 130 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
