html-css-to-wpf-xaml

majiayu000's avatarfrom majiayu000

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으로 변환

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026

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.
namehtml-css-to-wpf-xaml
descriptionConverts 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 새 케이스 추가용 템플릿