Como você mantém o desempenho de renderização CSS (reflow vs repaint)?

Question

Accepted Answer

O navegador converte alterações de CSS em pixels através de um pipeline, e diferentes mudanças acionam diferentes estágios (mais ou menos caros):

```text
Style → Layout (reflow) → Paint → Composite
```

- **Layout / reflow** — recálculo de geometria (posições/tamanhos). **Mais caro** — alterar um elemento pode forçar o recálculo de muitos outros.
- **Paint / repaint** — preenchimento de pixels (cores, texto, sombras). Mais barato que layout.
- **Composite** — combinação de camadas já pintadas (GPU). **Mais barato**.

## Por que isso importa

```css
/* ❌ trigger LAYOUT (reflow) — costly, recalculates geometry every frame */
width, height, top, left, margin, padding, font-size

/* ⚠️ trigger PAINT — repaint pixels */
color, background, box-shadow, border-radius

/* ✅ trigger only COMPOSITE — GPU, no layout/paint */
transform, opacity
```

Esta é a única regra de desempenho mais importante: **animar `transform` e `opacity`, não `width`/`top`/`margin`.** Animar propriedades de layout executa layout a cada quadro (jank); transformações são compostas pela GPU (suave 60fps).

```css
/* ❌ janky */ @keyframes a { to { left: 300px; width: 200px; } }
/* ✅ smooth */ @keyframes b { to { transform: translateX(300px) scaleX(2); } }
```

## Hint the browser with will-change (sparingly)

```css
.animated { will-change: transform; } /* promotes to its own GPU layer ahead of time */
```

Use `will-change` apenas em elementos prestes a ser animados — o uso excessivo desperdiça memória criando muitas camadas.

## Evitar layout thrashing em JS

```js
// ❌ read-write-read-write forces multiple synchronous reflows
for (const el of els) { el.style.width = el.offsetWidth + 10 + "px"; }
// ✅ batch reads, then writes
const widths = els.map(el => el.offsetWidth);
els.forEach((el, i) => el.style.width = widths[i] + 10 + "px");
```

## Outras vitórias

```text
- contain: layout/paint — isolate a subtree so changes don't reflow the whole page
- content-visibility: auto — skip rendering offscreen content
- minimize deep selectors and huge unused stylesheets
```

## Por que isso importa

O desempenho de renderização é principalmente sobre *não acionar layout repetidamente*.

Saber que `transform`/`opacity` são apenas para composição (baratos) enquanto `width`/`top`/`margin` forçam reflow (caros) — além de evitar layout thrashing e usar `contain`/`content-visibility` — é o que mantém as animações em 60fps e as páginas se sentindo rápidas.