--- title: clip-path slug: Web/CSS/clip-path tags: - CSS - CSS Masking - CSS Property - Experimental - Reference - Web translation_of: Web/CSS/clip-path ---
{{CSSRef}}

clip-path CSS 속성은 요소의 클리핑 범위를 지정합니다. 클리핑 범위 안의 부분은 보여지고, 바깥은 숨겨집니다.

{{EmbedInteractiveExample("pages/css/clip-path.html")}}

구문

/* 키워드 값 */
clip-path: none;

/* <clip-source> 값 */
clip-path: url(resources.svg#c1);

/* <geometry-box> 값 */
clip-path: margin-box;
clip-path: border-box;
clip-path: padding-box;
clip-path: content-box;
clip-path: fill-box;
clip-path: stroke-box;
clip-path: view-box;

/* <basic-shape> 값 */
clip-path: inset(100px 50px);
clip-path: circle(50px at 0 100px);
clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%);
clip-path: path('M0.5,1 C0.5,1,0,0.7,0,0.3 A0.25,0.25,1,1,1,0.5,0.3 A0.25,0.25,1,1,1,1,0.3 C1,0.7,0.5,1,0.5,1 Z');

/* 박스와 도형 값 조합 */
clip-path: padding-box circle(50px at 0 100px);

/* 전역 값 */
clip-path: inherit;
clip-path: initial;
clip-path: unset;

clip-path 속성은 아래의 값을 하나 이상 조합해 지정할 수 있습니다.

값

<clip-source>
SVG {{SVGElement("clipPath")}} 요소를 가리키는 {{cssxref("<url>")}}.
{{cssxref("<basic-shape>")}}
<geometry-box> 값으로 크기와 위치가 정해지는 도형. <geometry-box>를 지정하지 않는다면 border-box를 참조 박스로 사용합니다.
<geometry-box>
<basic-shape>와 함께 지정하면, <basic-shape>의 참조 박스를 정의합니다. 단독으로 지정한 경우, 값으로 주어진 상자와 그 상자의 모서리 형태({{cssxref("border-radius")}} 등)를 클리핑 패스로 적용합니다. 가능한 값은 다음과 같습니다.
margin-box
바깥 여백 상자를 참조로 사용합니다.
border-box
테두리 상자를 참조로 사용합니다.
padding-box
안쪽 여백 상자를 참조로 사용합니다.
content-box
콘텐츠 상자를 참조로 사용합니다.
fill-box
객체의 바운딩 상자를 참조로 사용합니다.
stroke-box
테두리 바운딩 상자를 참조로 사용합니다.
view-box
가장 가까운 SVG 뷰포트를 참조 상자로 사용합니다. SVG 뷰포트를 생성한 요소가 {{SVGAttr("viewBox")}} 속성을 가진 경우, 참조 상자의 위치는 viewBox 속성이 정의하는 좌표계의 원점에 위치하고, 크기는 viewBox 속성의 너비와 높이 값과 동일합니다.
none
클리핑 패스를 생성하지 않습니다.

참고: {{cssxref("opacity")}}가 1이 아닌 값일 때와 마찬가지로, none 외의 계산값은 새로운 쌓임 맥락을 생성합니다.

형식 구문

{{csssyntax}}

예제

HTML과 SVG의 차이점

{{EmbedLiveSample("clip-path", "100%", 800, "", "", "example-outcome-frame")}}

완전한 예제

HTML

<img id="clipped" src="https://mdn.mozillademos.org/files/12668/MDN.svg"
    alt="MDN logo">
<svg height="0" width="0">
  <defs>
    <clipPath id="cross">
      <rect y="110" x="137" width="90" height="90"/>
      <rect x="0" y="110" width="90" height="90"/>
      <rect x="137" y="0" width="90" height="90"/>
      <rect x="0" y="0" width="90" height="90"/>
    </clipPath>
  </defs>
</svg>

<select id="clipPath">
  <option value="none">none</option>
  <option value="circle(100px at 110px 100px)">circle</option>
  <option value="url(#cross)" selected>cross</option>
  <option value="inset(20px round 20px)">inset</option>
  <option value="path('M 0 200 L 0,110 A 110,90 0,0,1 240,100 L 200 340 z')">path</option>
</select>

CSS

#clipped {
  margin-bottom: 20px;
  clip-path: url(#cross);
}

결과

{{EmbedLiveSample("완전한_예제", 230, 250)}}

명세

Specification Status Comment
{{SpecName("CSS Masks", "#the-clip-path", 'clip-path')}} {{Spec2('CSS Masks')}} Extends its application to HTML elements. The clip-path property replaces the deprecated {{cssxref("clip")}} property.
{{SpecName('SVG1.1', 'masking.html#ClipPathProperty', 'clip-path')}} {{Spec2('SVG1.1')}} Initial definition (applies to SVG elements only).
{{SpecName("CSS Shapes 2", "#supported-basic-shapes", 'path')}} {{Spec2('CSS Shapes 2')}} Defines path().

{{cssinfo}}

브라우저 호환성

{{Compat("css.properties.clip-path")}}

같이 보기