[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -2,98 +2,156 @@
|
||||
id: wiki-2026-0508-cssom
|
||||
title: CSSOM
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: []
|
||||
aliases: [CSS Object Model, "CSSOM(CSS Object Model)"]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.92
|
||||
tags: [uncategorized]
|
||||
confidence_score: 0.9
|
||||
verification_status: applied
|
||||
tags: [css, dom, browser, frontend, render]
|
||||
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: none
|
||||
---
|
||||
|
||||
# [[CSSOM|CSSOM]]
|
||||
# CSSOM
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
[[CSSOM(CSS Object Model)|CSSOM(CSS Object Model]]은 웹 페이지의 시각적 외관을 정의하는 스타일 정보의 트리 구조입니다 [1-3]. DOM 생성과 달리 점진적으로 구성되지 않으며, 화면 렌더링을 차단(render-Blocking)하는 특징이 있습니다 [1, 2]. 구축된 CSSOM은 DOM과 결합하여 브라우저가 화면에 요소를 계산하고 그리는 데 사용하는 렌더 트리([[Render Tree|Render Tree]])를 합성하는 핵심 역할을 합니다 [3-5].
|
||||
## 매 한 줄
|
||||
> **"매 CSS 의 JS-accessible object tree"**. CSSOM (CSS Object Model) 은 browser 가 parsed CSS 의 representation 의 object 의 노출 의 API. DOM 의 sibling 의 매 render tree 의 input. 2026 modern browser 의 매 `getComputedStyle`, CSS Typed OM (Houdini) 의 안정 사용.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
* **생성 과정 및 특징**
|
||||
브라우저는 CSS 코드를 파싱하여 CSSOM 트리를 생성하며, 여기에는 브라우저의 기본 사용자 에이전트(user agent) 스타일시트도 포함됩니다 [6, 7]. 브라우저는 CSS 규칙을 자신이 이해할 수 있는 스타일 맵으로 변환하고, CSS 선택자를 기반으로 부모, 자식, 형제 관계를 가지는 노드 트리를 구성합니다 [6]. 이 과정에서 가장 일반적인 규칙부터 시작하여 더 구체적인 규칙을 재귀적으로 적용하며 속성값을 캐스케이딩(Cascading)합니다 [7, 8].
|
||||
## 매 핵심
|
||||
|
||||
* **렌더링 차단 (Render-Blocking) 특성**
|
||||
HTML의 DOM 생성은 점진적으로 이루어지지만 CSSOM은 그렇지 않으며 렌더링을 차단하는 작업입니다 [1, 2]. CSS 규칙은 이후에 파싱되는 규칙에 의해 덮어씌워질 수 있기 때문에, 브라우저는 스타일시트를 모두 다운로드하고 파싱하여 CSSOM을 완성할 때까지 페이지 렌더링을 중단합니다 [2, 8]. 이는 사용자가 스타일이 적용되지 않은 날 것의 HTML을 보게 되는 "스타일이 적용되지 않은 콘텐츠의 번쩍임(FOUC, Flash of Unstyled Content)" 현상을 방지하기 위한 안전장치입니다 [1].
|
||||
### 매 CSSOM 구조
|
||||
- `document.styleSheets` — `StyleSheetList`
|
||||
- 각 `CSSStyleSheet` → `cssRules` (CSSRule list)
|
||||
- `CSSStyleRule` → `selectorText`, `style` (CSSStyleDeclaration)
|
||||
- `element.style` — inline style 의 declaration
|
||||
- `getComputedStyle(el)` — cascaded + inherited final value
|
||||
|
||||
* **선택자 복잡도와 성능**
|
||||
CSS 선택자의 복잡도는 CSSOM 구성 속도에 영향을 미칩니다 [9]. 브라우저는 선택자를 오른쪽에서 왼쪽으로 파싱하기 때문에, 특정 요소를 깊게 지칭하는 구체적인 선택자일수록 브라우저 엔진이 조상 관계를 확인하기 위해 DOM 트리를 거슬러 올라가야 하므로 더 많은 연산 작업을 요구합니다 [9, 10]. 하지만 최신 브라우저의 CSSOM 구축 및 파싱 속도는 매우 빠르며, 일반적으로 DNS 조회에 걸리는 시간보다도 적게 소요됩니다 [7, 10].
|
||||
### 매 Render pipeline 의 위치
|
||||
1. HTML → DOM tree
|
||||
2. CSS → CSSOM tree
|
||||
3. **DOM + CSSOM → Render tree**
|
||||
4. Layout (reflow) → Paint → Composite
|
||||
|
||||
* **렌더 트리(Render Tree)의 합성**
|
||||
CSSOM과 DOM의 구축이 모두 준비되면, 브라우저는 이 두 트리를 결합하여 렌더 트리를 생성합니다 [4, 5, 11]. 렌더 트리는 화면에 표시되는 콘텐츠와 그에 해당하는 계산된 스타일(computed styles)만을 포함하며, `display: none`으로 스타일링된 숨김 요소나 `<head>`, `<script>` 같은 비시각적 노드는 렌더 트리에서 제외됩니다 [4, 5, 11].
|
||||
### 매 CSSOM 조작 의 cost
|
||||
- `style` 읽기/쓰기: 매 cheap (inline 만)
|
||||
- `getComputedStyle`: 매 expensive (force layout)
|
||||
- `cssRules` 의 mutation: 매 sheet 전체 invalidation
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
- **Related Topics:** [[DOM (Document Object Model)|DOM (Document Object Model]], Render Tree, [[Critical Rendering Path (CRP)|Critical Rendering Path (CRP]]
|
||||
- **Projects/Contexts:** [[Browser|Browser]] Rendering Process, [[Web Performance Optimization|Web Performance Optimization]]
|
||||
- **Contradictions/Notes:** 소스에 따르면 더 구체적인 CSS 선택자가 파싱 비용을 증가시키긴 하지만, 브라우저가 이를 마이크로초 단위로 처리할 만큼 속도가 매우 빠르기 때문에 선택자 성능 최적화 자체에만 집중하기보다는 CSS 파일을 최소화(minification)하거나 미디어 쿼리로 비차단(non-blocking) 요청을 분리하는 등 다른 최적화 방식이 더 큰 효과를 줄 수 있다고 조언합니다 [7, 10].
|
||||
### 매 응용
|
||||
1. Theme switching (CSS variable 의 JS 조작).
|
||||
2. Animation (Web Animations API).
|
||||
3. Style introspection (DevTools, testing).
|
||||
4. Houdini (CSS Typed OM, Paint Worklet).
|
||||
5. Stylesheet 의 동적 generation.
|
||||
|
||||
---
|
||||
*Last updated: 2026-04-25*
|
||||
## 💻 패턴
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
### CSS Variable 의 JS 조작
|
||||
```js
|
||||
const root = document.documentElement;
|
||||
root.style.setProperty('--accent', '#0070f3');
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
|
||||
## 🧪 검증 상태 (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
|
||||
// 읽기
|
||||
const accent = getComputedStyle(root)
|
||||
.getPropertyValue('--accent')
|
||||
.trim();
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### getComputedStyle (final value)
|
||||
```js
|
||||
const el = document.querySelector('.card');
|
||||
const styles = getComputedStyle(el);
|
||||
console.log(styles.fontSize); // "16px"
|
||||
console.log(styles.color); // "rgb(17, 17, 17)"
|
||||
console.log(styles.gridTemplateColumns); // resolved tracks
|
||||
```
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### Inline style 직접
|
||||
```js
|
||||
el.style.transform = 'translateX(100px)';
|
||||
el.style.setProperty('--x', '100px');
|
||||
```
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### CSSStyleSheet API (constructable)
|
||||
```js
|
||||
const sheet = new CSSStyleSheet();
|
||||
sheet.replaceSync(`
|
||||
.toast { background: #111; color: #fff; padding: 1rem; }
|
||||
`);
|
||||
document.adoptedStyleSheets = [...document.adoptedStyleSheets, sheet];
|
||||
```
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
### CSS Typed OM (Houdini)
|
||||
```js
|
||||
const el = document.querySelector('.box');
|
||||
el.attributeStyleMap.set('width', CSS.px(200));
|
||||
const w = el.computedStyleMap().get('width');
|
||||
console.log(w.value, w.unit); // 200, "px"
|
||||
```
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
### Stylesheet 의 inspection
|
||||
```js
|
||||
for (const sheet of document.styleSheets) {
|
||||
try {
|
||||
for (const rule of sheet.cssRules) {
|
||||
if (rule.type === CSSRule.STYLE_RULE) {
|
||||
console.log(rule.selectorText, rule.style.cssText);
|
||||
}
|
||||
}
|
||||
} catch (e) {
|
||||
// CORS-blocked external sheet
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
### Web Animations API (CSSOM 기반)
|
||||
```js
|
||||
el.animate(
|
||||
[{ opacity: 0 }, { opacity: 1 }],
|
||||
{ duration: 300, easing: 'ease-out', fill: 'forwards' }
|
||||
);
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| Final computed value 필요 | `getComputedStyle` |
|
||||
| CSS variable toggle | `style.setProperty('--x', ...)` |
|
||||
| Dynamic stylesheet | `CSSStyleSheet` + `adoptedStyleSheets` |
|
||||
| Type-safe value | CSS Typed OM (`CSS.px()`) |
|
||||
| 1회 animation | Web Animations API |
|
||||
| 큰 DOM 의 style read | batch — RAF 의 sync |
|
||||
|
||||
**기본값**: CSS variable + `setProperty` (가장 cheap + composable).
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[DOM]] · [[Browser Rendering]]
|
||||
- 변형: [[CSS Typed OM]] · [[Houdini]]
|
||||
- 응용: [[Theme Switching]] · [[Web Animations API]]
|
||||
- Adjacent: [[Render Tree]] · [[Critical Rendering Path]] · [[CSS Variables]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: theme system, dynamic styling, JS-driven animation 코드 generation.
|
||||
**언제 X**: 매 declarative CSS 의 sufficient — 매 JS 의 X.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **Layout thrashing**: read → write → read pattern — 매 batch read first.
|
||||
- **`style.cssText` 의 overwrite**: 기존 style 의 destroy — 매 individual property.
|
||||
- **`!important` 의 JS 의 abuse**: cascade 의 deadlock.
|
||||
- **모든 frame 의 `getComputedStyle`**: layout force — RAF 의 sync.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (W3C CSSOM spec, MDN CSSOM, Houdini).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — CSSOM API + Typed OM + WAAPI |
|
||||
|
||||
Reference in New Issue
Block a user