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 Wirkung, wenn das Attribut viewBox auf dem <pattern>-Element angegeben ist.

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

Beispiel

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>

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 gibt an, dass sich sämtliche Koordinaten innerhalb des <pattern>-Elements auf das Benutzerkoordinatensystem beziehen, wie es beim Erstellen der Mustervorlage definiert wurde.

objectBoundingBox

Dieser Wert gibt an, dass sich sämtliche Koordinaten innerhalb des <pattern>-Elements relativ zur Begrenzungsbox des Elements beziehen, auf das das Muster angewendet wird. Eine Begrenzungsbox könnte als identisch 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

BCD tables only load in the browser