converting-html-css-to-wpf-xaml

name	converting-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	새 케이스 추가용 템플릿