clip-rule

Baseline Widely available

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

« SVG Attribut-Referenz-Startseite

Das Attribut clip-rule gilt nur für Grafikelemente, die in einem <clipPath>-Element enthalten sind. Das Attribut clip-rule funktioniert im Wesentlichen wie das Attribut fill-rule, außer dass es auf <clipPath>-Definitionen angewendet wird.

Das folgende Codefragment wird dazu führen, dass eine evenodd-Clipping-Regel auf den Clipping-Pfad angewendet wird, da clip-rule auf dem <path>-Element angegeben wird, das die Clipping-Form definiert:

html
<g>
  <clipPath id="MyClip">
    <path d="..." clip-rule="evenodd" />
  </clipPath>
  <rect clip-path="url(#MyClip)" ... />
</g>

während das folgende Codefragment nicht dazu führt, dass eine evenodd-Clipping-Regel angewendet wird, da die clip-rule auf das referenzierende Element und nicht auf das Objekt, das die Clipping-Form definiert, spezifiziert wird:

html
<g>
  <clipPath id="MyClip">
    <path d="..." />
  </clipPath>
  <rect clip-path="url(#MyClip)" clip-rule="evenodd" ... />
</g>

Als Präsentationsattribut kann es auch als Eigenschaft direkt innerhalb eines CSS Stylesheets verwendet werden.

Verwendungshinweise

Wert nonzero | evenodd | inherit
Standardwert nonzero
Animierbar Ja
nonzero

Siehe Beschreibung der Eigenschaft fill-rule.

evenodd

Siehe Beschreibung der Eigenschaft fill-rule.

Beispiel

html
<svg
  width="100"
  viewBox="0 0 100 90"
  xmlns="http://www.w3.org/2000/svg"
  version="1.1">
  <!-- Define star path -->
  <defs>
    <path d="M50,0 21,90 98,35 2,35 79,90z" id="star" />
  </defs>

  <!-- Left: evenodd -->
  <clipPath id="emptyStar">
    <use href="#star" clip-rule="evenodd" />
  </clipPath>
  <rect clip-path="url(#emptyStar)" width="50" height="90" fill="blue" />

  <!-- Right: nonzero -->
  <clipPath id="filledStar">
    <use href="#star" clip-rule="nonzero" />
  </clipPath>
  <rect clip-path="url(#filledStar)" width="50" height="90" x="50" fill="red" />
</svg>

Elemente

Die folgenden Elemente können das Attribut clip-rule verwenden, jedoch nur, wenn sie sich innerhalb eines <clipPath>-Elements befinden.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch