js-batch-dom-css · tech-leads-club — Claude Code rule: what it does
js-batch-dom-css prevents layout thrashing by separating style updates from layout queries. Helps Claude write performant DOM and React code.
MIT ★ 7,191 updated 2026-10-24
.claude/rules/js-batch-dom-css.mdWhat js-batch-dom-css does
The rule guides the coding agent to batch DOM manipulations. Interleaving style assignments with reads such as offsetWidth, offsetHeight, or getBoundingClientRect() forces the browser into costly synchronous reflows.
It establishes a strict separation: execute all layout queries first, then apply style changes, or bundle all mutations before querying. For React components, it instructs the model to toggle CSS classes rather than mutating node styles inside useEffect.
Position: inline style changes are treated as a fallback, so the rule pushes class toggles wherever styles can live in external stylesheets.
What it helps with
- prevent forced synchronous reflows in DOM scripts
- separate geometry reads from style mutations into distinct phases
- replace inline style assignments with CSS class toggles
- eliminate layout thrashing inside React lifecycle hooks
Example prompts for the agent
- Refactor this DOM update logic to eliminate layout thrashing
- Check this React effect for forced synchronous reflow calls
- Batch the bounding box reads before applying transform styles
How to install js-batch-dom-css
Manually: put the files in place
.claude/rules/js-batch-dom-css.mdThe paths frontmatter field limits the files
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/js-batch-dom-css.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/js-batch-dom-css.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/js-batch-dom-css.mdManually: put the files in place
.clinerules/js-batch-dom-css.mdStep by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use
Questions about js-batch-dom-css
How to install js-batch-dom-css in Claude Code?
Save the rule content into .claude/rules/js-batch-dom-css.md in your repository root.
What layout calls does this rule flag?
It targets geometry reads like offsetWidth, offsetHeight, getBoundingClientRect(), and getComputedStyle() executed between style writes.
Why does the rule prefer CSS classes over inline styles?
CSS stylesheets are cached by browsers, keep concerns separate, and avoid accidental layout recalculations triggered by inline updates.
Source text
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
Similar IDE rules
All IDE rules for Frontend and UI →js-batch-dom-css by other authors comes first.