docs(10_Wiki): Dev 폴더 누락분 반영 — Topic_Programming으로 통합

이전 재구성 작업에서 Dev/ 폴더가 누락되었던 것을 반영.

- Dev/Topic_Programming(중첩 폴더, 78개)은 Dev 자체 최상위 폴더들
  (Architecture/Conventions/Engineering_Intelligence 등)과 완전 중복이라 제거.
- Dev 최상위 엔지니어링 지식 폴더(Architecture/Conventions/Engineering_Intelligence/
  Failure_Library/Generalized_Principles/Language/Pattern_Catalog/Platform_Guides/
  Subsystems, 77개)는 이미 Topic_Programming/Topic_Programming에 더 최신 버전이
  존재해 중복 제거(고유 콘텐츠 1개는 예외 처리하여 이동 보존).
- Dev의 W3Schools 언어 튜토리얼 폴더(Topic_C/CPP/CSS/CSharp/HOWTO/HTML/Java/
  JavaScript/PHP/Python/SQL/W3CSS, 1201개)는 전부 Topic_Programming 하위로 이동.
- 에이전트 운영 상태(.astra/docs)는 그대로 유지, 콘텐츠 폴더만 정리.
- Topic_Programming 최종 문서 수: 2784 → 3985.
This commit is contained in:
Antigravity Agent
2026-07-05 00:39:13 +09:00
parent 9148c358d0
commit e9cbf23ab5
1356 changed files with 0 additions and 12831 deletions
@@ -0,0 +1,132 @@
---
id: css-masking-with-gradients
title: "CSS Masking with Gradients"
category: "Frontend"
status: "draft"
verification_status: "conceptual"
canonical_id: ""
aliases: ["gradient mask", "linear-gradient mask", "radial-gradient mask", "conic-gradient mask", "mask-image gradient"]
duplicate_of: ""
source_trust_level: "B"
confidence_score: 0.87
created_at: 2026-06-23
updated_at: 2026-06-23
review_reason: ""
merge_history: []
tags: ["css", "web", "frontend", "w3schools", "masking", "gradients", "mask-image"]
raw_sources: ["https://www.w3schools.com/css/css3_masking_gradients.asp"]
applied_in: []
github_commit: ""
---
# [[CSS Masking with Gradients]]
## 🎯 한 줄 통찰 (One-line insight)
A CSS gradient can be used as a mask layer image, letting `mask-image` fade or shape an element using linear, radial, or conic gradients. [S1]
## 🧠 핵심 개념 (Core concepts)
- **Gradient as mask** — `mask-image` can take a CSS gradient as its mask layer. [S1]
- **Gradient types** — the page demonstrates linear, radial (circle and ellipse), and conic gradient masks. [S1]
- **Black vs transparent** — in a gradient mask, the gradient's opaque (black) regions reveal the element and transparent regions hide it. [S1]
- **`-webkit-` prefix** — examples pair `mask-image` with `-webkit-mask-image`. [S1]
## 🧩 추출된 패턴 (Extracted patterns)
- **Fade-out mask** — `linear-gradient(black, transparent)` fades an element from fully visible to hidden. [S1]
- **Soft vignette / spotlight** — `radial-gradient(circle, black 50%, rgba(0,0,0,0.5) 50%)` reveals a central region fully and partially dims the rest. [S1]
- **Rotational mask** — `conic-gradient(black 0deg, transparent 360deg)` sweeps visibility around a center. [S1]
## 📖 세부 내용 (Details)
**Linear gradient mask layer** [S1]
```css
.mask1 {
-webkit-mask-image: linear-gradient(black, transparent);
mask-image: linear-gradient(black, transparent);
}
```
A second linear-gradient example applies the mask over a background image. [S1]
```css
.mask1 {
max-width: 600px;
height: 400px;
background: url(img_5terre.jpg) no-repeat;
-webkit-mask-image: linear-gradient(black, transparent);
mask-image: linear-gradient(black, transparent);
}
```
**Radial gradient mask layer — circle** [S1]
```css
.mask2 {
-webkit-mask-image: radial-gradient(circle, black 50%, rgba(0, 0, 0, 0.5) 50%);
mask-image: radial-gradient(circle, black 50%, rgba(0, 0, 0, 0.5) 50%);
}
```
**Radial gradient mask layer — ellipse** [S1]
```css
.mask3 {
-webkit-mask-image: radial-gradient(ellipse, black 50%, rgba(0, 0, 0, 0.5) 50%);
mask-image: radial-gradient(ellipse, black 50%, rgba(0, 0, 0, 0.5) 50%);
}
```
**Conic gradient mask layer** [S1]
```css
.mask3 {
-webkit-mask-image: conic-gradient(black 0deg, transparent 360deg);
mask-image: conic-gradient(black 0deg, transparent 360deg);
}
```
**CSS masking properties reference** [S1]
| Property | Description |
|---|---|
| `mask-clip` | Specifies which area is affected by a mask image |
| `mask-composite` | Specifies a compositing operation used on the current mask layer with the mask layers below it |
| `mask-image` | Specifies an image to be used as a mask layer for an element |
| `mask-mode` | Specifies whether the mask layer image is treated as a luminance mask or as an alpha mask |
| `mask-origin` | Specifies the origin position of a mask layer image |
| `mask-position` | Sets the starting position of a mask layer image |
| `mask-repeat` | Specifies how the mask layer image is repeated |
| `mask-size` | Specifies the size of a mask layer image |
| `mask-type` | Specifies whether an SVG element is treated as a luminance mask or as an alpha mask |
## 🛠️ 적용 사례 (Applied in summary)
The page's own examples are the applied cases: linear, radial (circle/ellipse), and conic gradients applied as mask layers (including one over the `img_5terre.jpg` background). No external project/commit applications found in the source.
## 💻 코드 패턴 (Code patterns)
Fade an element out with a linear gradient mask (language: CSS):
```css
.mask1 {
-webkit-mask-image: linear-gradient(black, transparent);
mask-image: linear-gradient(black, transparent);
}
```
## ⚖️ 비교 및 선택 기준 (Comparison & decision criteria)
- **Linear gradient** — for directional fades (top-to-bottom, left-to-right). [S1]
- **Radial gradient (circle / ellipse)** — for a centered spotlight or vignette effect. [S1]
- **Conic gradient** — for a rotational/angular reveal around a center point. [S1]
## ⚖️ 모순 및 업데이트 (Contradictions & updates)
No contradictions found in the source.
## ✅ 검증 상태 및 신뢰도
- **상태:** draft
- **검증 단계:** conceptual (실제 적용 사례 발견 시 applied/validated로 승격 가능)
- **출처 신뢰도:** B (W3Schools — widely used educational reference, not a primary standards body)
- **신뢰 점수:** 0.87
- **중복 검사 결과:** 신규 생성 (New discovery)
## 🔗 지식 그래프 (Knowledge Graph)
- **상위/루트:** [[CSS Tutorial]]
- **관련 개념:** [[CSS Masking PNG]], [[CSS Masking SVG]], [[CSS Gradients]]
- **참조 맥락:** Referenced when fading or shaping an element's visibility using a gradient-based mask layer.
## 📚 출처 (Sources)
- [S1] W3Schools — CSS Masking with Gradients — https://www.w3schools.com/css/css3_masking_gradients.asp
## 📝 변경 이력 (Change history)
- 2026-06-23: Initial draft synthesized from the W3Schools "CSS Masking with Gradients" page (Astra wiki-curation, P-Reinforce v3.1 format).