clip-path

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2021.

Das clip-path Präsentationsattribut definiert oder verknüpft einen Clipping-Pfad mit dem zugehörigen Element.

Hinweis: Als Präsentationsattribut kann clip-path auch als CSS-Eigenschaft verwendet werden.

Sie können dieses Attribut mit den folgenden SVG-Elementen verwenden:

Beispiel

html
<svg viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
  <clipPath id="myClip" clipPathUnits="objectBoundingBox">
    <circle cx=".5" cy=".5" r=".5" />
  </clipPath>

  <!-- Top-left: Apply a custom defined clipping path -->
  <rect
    x="1"
    y="1"
    width="8"
    height="8"
    stroke="green"
    clip-path="url(#myClip)" />

  <!-- Top-right: Apply a CSS basic shape on a fill-box
       geometry. This is the same as having a custom clipping
       path with a clipPathUnits set to objectBoundingBox -->
  <rect
    x="11"
    y="1"
    width="8"
    height="8"
    stroke="green"
    clip-path="circle() fill-box" />

  <!-- Bottom-left -->
  <rect
    x="1"
    y="11"
    width="8"
    height="8"
    stroke="green"
    clip-path="circle() stroke-box" />

  <!-- Bottom-right: Apply a CSS basic shape on a view-box
       geometry. This is the same as having a custom clipping
       path with a clipPathUnits set to userSpaceOnUse -->
  <rect
    x="11"
    y="11"
    width="8"
    height="8"
    stroke="green"
    clip-path="circle() view-box" />
</svg>

Verwendungshinweise

Wert <url> | [ <basic-shape> || <geometry-box> ] | none
Standardwert none
Animierbar Ja
<geometry-box>

Eine zusätzliche Information, um anzugeben, wie eine <basic-shape> auf ein Element angewendet wird: fill-box gibt an, die Objektbegrenzungsrahmen zu verwenden; stroke-box gibt an, die Objektbegrenzungsrahmen erweitert mit dem Strich zu verwenden; view-box gibt an, den nächstgelegenen SVG-Viewport als Referenzrahmen zu verwenden.

Hinweis: Für mehr Details zur clip-path Syntax, siehe die CSS-Eigenschaftsreferenzseite clip-path.

Spezifikationen

Specification
CSS Masking Module Level 1
# the-clip-path

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch