html-css-to-wpf-xaml
HTML/CSS를 WPF CustomControl XAML로 변환할 때 필요한 가이드. CSS 애니메이션, overflow 클리핑, pseudo-element, 회전 요소 등을 WPF로 변환할 때 발생하는 일반적인 실수와 올바른 패턴을 제공한다. 다음 상황에서 사용: (1) HTML/CSS를 WPF XAML로 변환, (2) CSS 애니메이션을 WPF Storyboard로 변환, (3) CSS border-radius + overflow: hidden을 WPF 클리핑으로 구현, (4) CSS ::before/::after pseudo-element를 WPF로 구현, (5) CSS transform: rotate를 WPF RotateTransform으로 변환
When & Why to Use This Skill
This Claude skill facilitates the seamless conversion of HTML/CSS designs into WPF CustomControl XAML. It provides specialized patterns and solutions for translating complex web styling—including CSS animations, pseudo-elements, and advanced clipping—into native WPF structures, ensuring high visual fidelity and performance in desktop application development.
Use Cases
- Migrating modern web-based design systems to WPF desktop applications while maintaining consistent UI/UX.
- Translating complex CSS keyframe animations into native WPF Storyboards for smooth, high-performance transitions.
- Implementing advanced CSS layouts, such as absolute positioning and z-indexing, using WPF Canvas and Grid systems.
- Replicating intricate web effects like border-radius clipping and pseudo-elements (::before/::after) using XAML-specific techniques and converters.
- Solving common pitfalls in WPF UI development when attempting to mirror CSS transform and rotation behaviors.
| name | html-css-to-wpf-xaml |
|---|---|
| description | Converts HTML/CSS to WPF CustomControl XAML with correct patterns and common pitfall solutions. Use when transforming web designs to WPF, converting CSS animations to Storyboards, implementing CSS border-radius clipping, CSS pseudo-elements (::before/::after), or CSS transforms in XAML. |
HTML/CSS → WPF XAML 변환 가이드
CSS → WPF 핵심 매핑 테이블
| CSS | WPF 구현 방법 | 참조 |
|---|---|---|
overflow: hidden + border-radius |
Border.Clip + RectangleGeometry (RadiusX/Y + MultiBinding) |
clipping.md |
position: absolute (회전 요소) |
Canvas + Canvas.Left/Top |
layout.md |
animation-duration: 3s |
Duration="0:0:3" 인라인 |
animation.md |
height: 130% (회전 요소) |
Converter로 동적 계산 (배율 2.0) | transform.md |
::before, ::after |
Canvas 내 요소, 선언 순서로 z-order | layout.md |
z-index |
선언 순서 또는 Panel.ZIndex |
layout.md |
| 중앙 정렬 콘텐츠 | Canvas 밖 Grid에서 Alignment 적용 | layout.md |
spacing |
Maring 속성으로 대체 | - |
핵심 규칙 요약
1. Duration은 항상 인라인
<!-- ✅ -->
<DoubleAnimation Duration="0:0:3" />
<!-- ❌ StaticResource 바인딩 불가 -->
2. 둥근 모서리 클리핑은 Border.Clip + RectangleGeometry
<Border CornerRadius="20">
<Border.Clip>
<RectangleGeometry RadiusX="20" RadiusY="20">
<RectangleGeometry.Rect>
<MultiBinding Converter="{x:Static local:SizeToRectConverter.Instance}">
<Binding Path="ActualWidth" RelativeSource="{RelativeSource AncestorType=Border}" />
<Binding Path="ActualHeight" RelativeSource="{RelativeSource AncestorType=Border}" />
</MultiBinding>
</RectangleGeometry.Rect>
</RectangleGeometry>
</Border.Clip>
</Border>
3. 회전 요소는 Canvas 내 배치
<Canvas>
<Rectangle Canvas.Left="45" Canvas.Top="{Binding ...}" RenderTransformOrigin="0.5,0.5">
<Rectangle.RenderTransform>
<RotateTransform Angle="0" />
</Rectangle.RenderTransform>
</Rectangle>
</Canvas>
4. ContentPresenter는 Canvas 밖 Grid에 배치
<Grid>
<Canvas><!-- 회전 요소들 --></Canvas>
<ContentPresenter HorizontalAlignment="Center" VerticalAlignment="Center" />
</Grid>
참조 문서
| 파일 | 내용 |
|---|---|
| references/index.md | 전체 케이스 목록 (빠른 검색용) |
| references/clipping.md | 클리핑 관련 실수 (Grid.Clip, OpacityMask, ClipToBounds) |
| references/animation.md | 애니메이션/Duration 관련 |
| references/layout.md | Canvas/Grid/정렬, pseudo-element 관련 |
| references/transform.md | 회전/높이 계산 관련 |
| references/converters.md | 필수 Converter 패턴 |
| references/case-template.md | 새 케이스 추가용 템플릿 |