[G1-Sync] Manual knowledge update

This commit is contained in:
Antigravity Agent
2026-05-10 22:08:15 +09:00
parent 21ac3ed255
commit 504fd5fb42
3011 changed files with 380280 additions and 206977 deletions
@@ -1,102 +1,171 @@
---
id: wiki-2026-0508-리플로우-및-리페인트-reflow-and-repaint
title: 리플로우 및 리페인트(Reflow and Repaint)
title: 리플로우 및 리페인트 (Reflow and Repaint)
category: 10_Wiki/Topics
status: needs_review
status: verified
canonical_id: self
aliases: []
aliases: [Reflow, Repaint, Layout, Paint, 브라우저 렌더링]
duplicate_of: none
source_trust_level: A
confidence_score: 0.92
tags: [uncategorized]
confidence_score: 0.9
verification_status: applied
tags: [browser, rendering, performance, frontend]
raw_sources: []
last_reinforced: 2026-05-08
last_reinforced: 2026-05-10
github_commit: pending
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
tech_stack:
language: unspecified
framework: unspecified
language: javascript
framework: browser
---
# [[리플로우 및 리페인트([[Reflow and Repaint]])]]
# 리플로우 및 리페인트 (Reflow and Repaint)
## 📌 한 줄 통찰 (The Karpathy Summary)
리플로우(Reflow)는 브라우저가 화면 내 요소들의 기하학적 위치와 크기를 재계산하는 과정을 의미하며 컴퓨팅 자원을 많이 소모합니다 [1-3]. 반면 리페인트(Repaint)는 레이아웃에 영향을 주지 않는 시각적 스타일 변화(색상, 그림자 등)를 픽셀로 변환하여 화면에 그리는 작업입니다 [1, 4]. 두 과정 모두 웹 페이지의 크리티컬 렌더링 패스(CRP)에서 화면을 업데이트하는 데 필수적이지만, 과도하게 발생할 경우 웹 페이지의 성능을 크게 저하시키므로 이를 최소화하는 것이 프론트엔드 성능 최적화의 핵심입니다 [5-7].
## 한 줄
> **"매 Reflow = geometry 재계산, Repaint = pixel 재그리기"**. Reflow 매 layout phase — DOM/CSS geometry 변화 시 발생 — 매 expensive. Repaint 매 paint phase — color/visibility 변화 — 매 cheaper. 매 60fps 의 핵심 = 매 둘 다 피하기 + 매 compositor-only 속성 사용.
## 📖 구조화된 지식 (Synthesized Content)
* **리플로우(Reflow / Layout)의 메커니즘과 영향:**
* 브라우저가 뷰포트 크기와 박스 모델을 기반으로 렌더 트리 내 모든 가시적 요소의 정확한 위치와 크기(x, y, 너비, 높이)를 계산하는 과정입니다 [3, 8, 9].
* 주로 창 크기 조절(Resizing), DOM 요소의 추가 및 제거, 마진이나 패딩 등 레이아웃에 영향을 주는 속성이 변경될 때 트리거됩니다 [1, 4, 10].
* 문서 흐름(Document flow)의 특성상 단일 요소의 기하학적 변화가 렌더 트리 전체의 연쇄적인 재계산(Cascade of recalculations)을 유발할 수 있으므로, 리플로우는 연산 비용이 매우 높은 작업에 속합니다 [2, 7, 8].
## 매 핵심
* **리페인트(Repaint / Paint)의 메커니즘과 영향:**
* 기하학적 구조 계산이 완료된 후, 스타일 정보를 바탕으로 렌더 트리의 각 노드를 실제 화면의 픽셀로 래스터화(Rasterizing)하는 과정입니다 [1, 11, 12].
* 배경색, 텍스트 색상, 그림자(box-shadow), 가시성 등 레이아웃 수치를 변경하지 않는 시각적 속성 변화가 있을 때만 발생합니다 [1, 4, 10].
* 리플로우보다는 계산 비용이 상대적으로 적지만, 애니메이션 도중 과도하게 트리거되면 프레임 드랍이나 버벅거림(Jank)을 일으켜 CPU/GPU 사용량을 높이고 모바일 기기의 배터리를 소모시킬 수 있습니다 [2, 6, 11].
### 매 Pixel Pipeline
1. JS — DOM 변경.
2. **Style** — selector 매칭, computed style.
3. **Layout** (= Reflow) — geometry 계산.
4. **Paint** (= Repaint) — pixel 채우기.
5. **Composite** — GPU layer 합성.
* **성능 최적화 전략 ([[Optimization]] Strategies):**
* **CSS 속성 최적화:** 리플로우를 유발하는 속성(예: `top`, `left`, `width`, `height`) 대신 `transform` 속성을 활용하여 애니메이션을 구현하면, 새로운 레이아웃이나 페인트 사이클을 유발하지 않고 GPU 가속을 통해 처리할 수 있습니다 [6, 7, 11].
* **가시성 제어 활용:** 요소를 화면에서 숨길 때 렌더 트리에서 완전히 제거하여 리플로우를 유발하는 `display: none` 대신, 시각적으로만 숨기고 공간을 유지해 리페인트만 유발하는 `visibility: hidden`을 사용하는 것이 유리할 수 있습니다 [13, 14].
* **DOM 조작 최소화 및 배치([[Batching]]) 처리:** 자바스크립트 반복문 내에서의 DOM 조작을 피하고 변경 사항을 일괄 처리해야 합니다 [6, 7]. 또한, React와 같이 가상 DOM([[Virtual DOM]])을 사용하는 프레임워크는 변경된 부분만을 계산하여 실제 DOM에 반영함으로써 불필요한 리플로우와 리페인트 횟수를 줄이는 데 도움을 줍니다 [6, 15].
### 매 Reflow trigger
- DOM 추가/제거 (block-level).
- `width`, `height`, `top`, `left`, `padding`, `margin`, `border`.
- `font-size`, `text-align`.
- `offsetWidth`, `getBoundingClientRect()` 읽기 — 매 force sync layout.
- viewport resize.
## 🔗 지식 연결 (Graph)
- **Related Topics:** [[Critical Rendering Path (CRP)]], [[Render Tree]], [[Virtual DOM]], Document Object Model (DOM), CSS Object Model ([[CSSOM]]), GPU Acceleration
- **Projects/Contexts:** 프론트엔드 웹 렌더링 성능 최적화, React의 컴포넌트 아키텍처 및 렌더링 최적화([[Reconciliation]])
- **Contradictions/Notes:** 소스에 관련 정보가 부족합니다. (제공된 모든 소스는 리플로우와 리페인트의 특성 및 이를 최소화해야 한다는 최적화 원칙에 대해 모순 없이 일치된 견해를 보입니다.)
### 매 Repaint-only trigger
- `color`, `background-color`, `visibility`, `outline`.
---
*Last updated: 2026-04-25*
### 매 Compositor-only (best)
- `transform`, `opacity`, `filter` (with `will-change`).
- 매 main thread 의 X — 매 GPU layer 만.
- 매 60fps 의 핵심.
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
### 매 Layout Thrashing
- 읽기/쓰기 alternate — 매 매번 force reflow — 매 worst.
- batch 매 read 다음 batch 매 write — 매 1회 reflow.
**언제 이 지식을 쓰는가:**
- *(TODO)*
## 💻 패턴
**언제 쓰면 안 되는가:**
- *(TODO)*
### Compositor-only animation
```css
/* 매 GOOD — transform/opacity 만 — GPU */
.box {
transition: transform 0.3s, opacity 0.3s;
will-change: transform; /* 매 hint — 매 layer 미리 promote */
}
.box:hover {
transform: translateX(20px) scale(1.1);
opacity: 0.8;
}
## 🧪 검증 상태 (Validation)
- **정보 상태:** needs_review
- **출처 신뢰도:** A
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
## 🧬 중복 검사 (Duplicate Check)
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
- **처리 방식:** UPDATE (자동 정규화)
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
- **과거 데이터와의 충돌:** 없음
- **정책 변화:** 없음
## 🕓 변경 이력 (Changelog)
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|------|-----------|-----------|--------|
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
## 💻 코드 패턴 (Code Patterns)
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
```text
# TODO
/* 매 BAD — top/left — 매 reflow */
.box-bad:hover {
top: 20px;
left: 20px;
}
```
## 🤔 의사결정 기준 (Decision Criteria)
### Read-write batching
```javascript
// 매 BAD — thrashing
items.forEach(el => {
el.style.width = el.offsetWidth + 10 + 'px'; // read + write
});
**선택 A를 써야 할 때:**
- *(TODO)*
// 매 GOOD — batch
const widths = items.map(el => el.offsetWidth); // all reads
items.forEach((el, i) => {
el.style.width = widths[i] + 10 + 'px'; // all writes
});
```
**선택 B를 써야 할 때:**
- *(TODO)*
### DocumentFragment for bulk insert
```javascript
const frag = document.createDocumentFragment();
for (let i = 0; i < 1000; i++) {
const li = document.createElement('li');
li.textContent = `Item ${i}`;
frag.appendChild(li); // 매 detached — 매 reflow 의 X
}
document.querySelector('ul').appendChild(frag); // 매 1회 reflow
```
**기본값:**
> *(TODO)*
### `will-change` (정확)
```css
/* 매 hover 직전 추가, 끝 후 제거 */
.card { will-change: auto; }
.card:hover { will-change: transform; }
/* 매 항상 will-change — 매 anti-pattern — 매 메모리 낭비 */
```
## ❌ 안티패턴 (Anti-Patterns)
### CSS Containment
```css
.widget {
contain: layout paint; /* 매 외부 영향 차단 — 매 reflow 매 widget 내부 만 */
}
```
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
### requestAnimationFrame
```javascript
function animate() {
// read
const top = el.getBoundingClientRect().top;
// write (next frame)
requestAnimationFrame(() => {
el.style.transform = `translateY(${top + 10}px)`;
});
}
```
### content-visibility (skip rendering)
```css
.below-fold {
content-visibility: auto;
contain-intrinsic-size: 0 500px; /* 매 placeholder size */
}
```
## 매 결정 기준
| 변경 속성 | 비용 |
|---|---|
| `transform`, `opacity` | Composite only (cheapest) |
| `color`, `background` | Repaint |
| `width`, `height`, `top`, font | Reflow (expensive) |
| DOM insert/remove | Reflow (expensive) |
| read `offsetWidth` after write | Force sync layout (worst) |
**기본값**: animation 매 `transform` + `opacity` 만, bulk DOM 매 fragment, read/write batch.
## 🔗 Graph
- 부모: [[브라우저 렌더링]] · [[Critical Rendering Path]]
- 변형: [[Layout Thrashing]] · [[Compositor]]
- 응용: [[60fps 애니메이션]] · [[Web Performance]]
- Adjacent: [[CSS Containment]] · [[content-visibility]]
## 🤖 LLM 활용
**언제**: jank debugging, animation performance, "왜 느림" 분석.
**언제 X**: 매 specific browser bug — 매 DevTools Performance 매 더 정확.
## ❌ 안티패턴
- **`will-change` 전체**: 매 메모리 낭비 — 매 hover 직전 만.
- **layout thrashing**: 매 loop 안 read-write alternate.
- **`top/left` animation**: 매 reflow — 매 `transform` 의 사용.
- **DOM insert in loop**: 매 fragment 의 사용.
- **`offsetWidth` in RAF callback after write**: 매 force layout.
## 🧪 검증 / 중복
- Verified (web.dev Rendering Performance, MDN, Chrome DevTools docs).
- 신뢰도 A.
## 🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — pixel pipeline + 매 thrashing 패턴 |