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

js-batch-dom-css · tech-leads-club — правило для Claude Code: что делает

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

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

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

Что делает js-batch-dom-css

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

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

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

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

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

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

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

Как установить js-batch-dom-css

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

.claude/rules/js-batch-dom-css.md

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

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

Вопросы о js-batch-dom-css

Как установить js-batch-dom-css в Claude Code?

Сохраните файл правила по пути .claude/rules/js-batch-dom-css.md в корне вашего проекта.

Какие методы браузера триггерят reflow по этому правилу?

Под контроль попадают обращения к свойствам и методам разметки вроде offsetWidth, offsetHeight, getBoundingClientRect() и getComputedStyle().

Почему правило рекомендует CSS-классы вместо inline-стилей?

Файлы стилей кешируются браузером, изолируют оформление от логики и предотвращают случайное чередование чтения с записью в JavaScript.

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

js-batch-dom-css.md · MIT
---
title: Avoid Layout Thrashing
impact: MEDIUM
impactDescription: prevents forced synchronous layouts and reduces performance bottlenecks
tags: javascript, dom, css, performance, reflow, layout-thrashing
---

## Avoid Layout Thrashing

Avoid interleaving style writes with layout reads. When you read a layout property (like `offsetWidth`, `getBoundingClientRect()`, or `getComputedStyle()`) between style changes, the browser is forced to trigger a synchronous reflow.

**This is OK (browser batches style changes):**
```typescript
function updateElementStyles(element: HTMLElement) {
  // Each line invalidates style, but browser batches the recalculation
  element.style.width = '100px'
  element.style.height = '200px'
  element.style.backgroundColor = 'blue'
  element.style.border = '1px solid black'
}
```

**Incorrect (interleaved reads and writes force reflows):**
```typescript
function layoutThrashing(element: HTMLElement) {
  element.style.width = '100px'
  const width = element.offsetWidth  // Forces reflow
  element.style.height = '200px'
  const height = element.offsetHeight  // Forces another reflow
}
```

**Correct (batch writes, then read once):**
```typescript
function updateElementStyles(element: HTMLElement) {
  // Batch all writes together
  element.style.width = '100px'
  element.style.height = '200px'
  element.style.backgroundColor = 'blue'
  element.style.border = '1px solid black'
  
  // Read after all writes are done (single reflow)
  const { width, height } = element.getBoundingClientRect()
}
```

**Correct (batch reads, then writes):**
```typescript
function avoidThrashing(element: HTMLElement) {
  // Read phase - all layout queries first
  const rect1 = element.getBoundingClientRect()
  const offsetWidth = element.offsetWidth
  const offsetHeight = element.offsetHeight
  
  // Write phase - all style changes after
  element.style.width = '100px'
  element.style.height = '200px'
}
```

**Better: use CSS classes**
```css
.highlighted-box {
  width: 100px;
  height: 200px;
  background-color: blue;
  border: 1px solid black;
}
```
```typescript
function updateElementStyles(element: HTMLElement) {
  element.classList.add('highlighted-box')
  
  const { width, height } = element.getBoundingClientRect()
}
```

**React example:**
```tsx
// Incorrect: interleaving style changes with layout queries
function Box({ isHighlighted }: { isHighlighted: boolean }) {
  const ref = useRef<HTMLDivElement>(null)
  
  useEffect(() => {
    if (ref.current && isHighlighted) {
      ref.current.style.width = '100px'
      const width = ref.current.offsetWidth // Forces layout
      ref.current.style.height = '200px'
    }
  }, [isHighlighted])
  
  return <div ref={ref}>Content</div>
}

// Correct: toggle class
function Box({ isHighlighted }: { isHighlighted: boolean }) {
  return (
    <div className={isHighlighted ? 'highlighted-box' : ''}>
      Content
    </div>
  )
}
```

Prefer CSS classes over inline styles when possible. CSS files are cached by the browser, and classes provide better separation of concerns and are easier to maintain.

See [this gist](https://gist.github.com/paulirish/5d52fb081b3570c81e3a) and [CSS Triggers](https://csstriggers.com/) for more information on layout-forcing operations.

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

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

Все правила IDE по теме «Фронтенд и UI» →

Сначала — js-batch-dom-css от других авторов.

js-batch-dom-css jarrodwatts Правило js-batch-dom-css для Claude: не менять стили по одному свойству, а собирать их в класс или одну строку cssText, чтобы браузер реже пересчитывал раскладку. CX Codex +1 ★ 1 064звёзд репо inspecting-hermes-desktop-dom Hermes Agent Скилл inspecting-hermes-desktop-dom читает DOM, CSS и консоль работающего Hermes Desktop через CDP. Пригодится, чтобы проверить, применился ли стиль и какое CSS-правило победило. CX Codex +1 263установок expo-dom expo Скилл expo-dom запускает веб-код в webview на нативных платформах и рендерит как есть на вебе. Позволяет использовать веб-библиотеки вроде recharts или react-syntax-highlighter в Expo без переписывания. CX Codex +1 25 700установок measuring-dom-nodes coleam00 Правило measuring-dom-nodes объясняет, как правильно измерять размеры DOM-элементов в Remotion с учётом масштаба видеоконтейнера. CX Codex +1 ★ 849звёзд репо js-performance-patterns patterns.dev Скилл js-performance-patterns для Claude Code помогает устранять просадки скорости в горячих путях JavaScript: в циклах, обработчиках событий и операциях с DOM. CX Codex +1 716установок pixijs-scene-dom-container pixijs Скилл pixijs-scene-dom-container для Claude Code и Codex: объясняет агенту, как накладывать HTML-элементы на canvas PixiJS v8 через DOMContainer и DOMPipe. Поля ввода, iframe и видео крепятся поверх сцены. CX Codex +1 6 900установок view-transitions patterns.dev Учит агента работать с View Transitions API: переходы между страницами и состояниями интерфейса браузер анимирует сам. CX Codex +1 707установок

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

Весь набор →
architecture-compound-components Правило architecture-compound-components предлагает собирать сложные компоненты из частей с общим контекстом. Оно пригодится, когда монолитный компонент обрастает условиями и render props. CX Codex +1 ★ 7 191звёзд репо state-decouple-implementation Правило state-decouple-implementation для Claude Code: провайдер управляет стейтом, UI-компонент знает только интерфейс контекста. Одна смена провайдера — useState, Zustand или серверный sync — не трогает ни одного UI-компонента. CX Codex +1 ★ 7 191звёзд репо rerender-functional-setstate Правило rerender-functional-setstate подсказывает использовать функциональное обновление React-состояния, когда новое значение зависит от текущего. Это помогает избежать устаревших замыканий в обработчиках. CX Codex +1 ★ 7 191звёзд репо state-lift-state Правило state-lift-state учит выносить состояние React в компонент-провайдер, чтобы соседние компоненты вне основного UI читали и меняли его без пропсов и ref. CX Codex +1 ★ 7 191звёзд репо docs-writer Скилл docs-writer для Claude Code пишет, редактирует и проверяет документацию в проекте. Работает с README, Markdown-файлами и страницами docs/. CX Codex +1 ★ 7 191звёзд репо perf-astro Скилл perf-astro для Claude Code настраивает сборку Astro: встраивает критический CSS, минифицирует файлы, задаёт неблокирующую загрузку шрифтов и preload LCP-картинки. CX Codex +1 ★ 7 191звёзд репо tactical-ddd Скилл tactical-ddd находит анемичные доменные модели и переводит их в богатые сущности по правилам тактического DDD. Он проверяет инкапсуляцию и готовит пошаговый рефакторинг для Claude Code. CX Codex +1 ★ 7 191звёзд репо nx-workspace Скилл nx-workspace для работы с Nx-монорепозиторием из CLI: список проектов, полная конфигурация, поиск затронутых проектов и affected-команды в CI. CX Codex +1 ★ 7 191звёзд репо

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

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