patternContentUnits

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.

Das Attribut patternContentUnits gibt an, welches Koordinatensystem für den Inhalt des <pattern>-Elements verwendet werden soll.

Hinweis: Dieses Attribut hat keine Auswirkung, wenn das Attribut viewBox auf dem <pattern>-Element angegeben ist.

Dieses Attribut kann mit den folgenden SVG-Elementen verwendet werden:

Beispiele

html
<svg viewBox="0 0 200 100" xmlns="http://www.w3.org/2000/svg">
  <!--
  A pattern tile that content coordinates and values are
  computed against the current coordinate user space.
  Note that the size of the tile is computed against
  the bounding box of the target element
  -->
  <pattern
    id="p1"
    width="20%"
    height="20%"
    patternContentUnits="userSpaceOnUse">
    <circle cx="10" cy="10" r="10" />
  </pattern>

  <!--
  A pattern tile that content coordinates and values are
  computed against the bounding box of the target element.
  Note that the size of the tile is also computed against
  the bounding box of the target element
  -->
  <pattern
    id="p2"
    width="20%"
    height="20%"
    patternContentUnits="objectBoundingBox">
    <circle cx=".1" cy=".1" r=".1" />
  </pattern>

  <!-- Left square with user space tiles -->
  <rect x="10" y="10" width="80" height="80" fill="url(#p1)" />

  <!-- Right square with bounding box tiles -->
  <rect x="110" y="10" width="80" height="80" fill="url(#p2)" />
</svg>

Elemente

Sie können dieses Attribut mit den SVG-Elementen verwenden, die in den untenstehenden Abschnitten beschrieben sind.

<pattern>

Für <pattern> definiert patternContentUnits das verwendete Koordinatensystem für den Inhalt des Elements.

Wert userSpaceOnUse | objectBoundingBox
Standardwert userSpaceOnUse
Animierbar Ja
userSpaceOnUse

Dieser Wert zeigt an, dass alle Koordinaten innerhalb des <pattern>-Elements zum Benutzerkoordinatensystem gehören, wie es bei der Erstellung der Mustervorlage definiert wurde.

objectBoundingBox

Dieser Wert zeigt an, dass alle Koordinaten innerhalb des <pattern>-Elements relativ zum Begrenzungsrahmen des Elements sind, auf das das Muster angewendet wird. Ein Begrenzungsrahmen könnte als dasselbe betrachtet werden, als ob der Inhalt des <pattern> an eine "0 0 1 1" viewBox für eine Mustervorlage mit einer Breite und Höhe von 100% gebunden wäre.

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# PatternElementPatternContentUnitsAttribute

Browser-Kompatibilität