js-batch-dom-css · tech-leads-club — правило для Claude Code: что делает
Правило js-batch-dom-css запрещает чередовать чтение геометрии DOM с записью стилей. Защищает код от синхронного reflow и просадок FPS при анимациях.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/js-batch-dom-css.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/js-batch-dom-css.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/js-batch-dom-css.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/js-batch-dom-css.mdВручную: положить файлы
.clinerules/js-batch-dom-css.mdПо шагам, с командами для каждой платформы: 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 от других авторов.