SVGPointList: Methode initialize()

Baseline Widely available

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

Die initialize()-Methode der SVGPointList-Schnittstelle leert die Liste und fügt dann ein einzelnes neues DOMPoint-Objekt zur Liste hinzu.

Syntax

js
initialize(obj)

Parameter

obj

Ein DOMPoint-Objekt, das die Koordinaten des Punkts enthält, der hinzugefügt werden soll, wenn die Liste initialisiert wird.

Rückgabewert

Das hinzugefügte DOMPoint-Objekt.

Ausnahmen

NoModificationAllowedError DOMException

Wird ausgelöst, wenn die Liste schreibgeschützt ist.

Beispiele

Das folgende Beispiel zeigt ein SVG, das ein <polyline> mit fünf Koordinatenpaaren enthält. Beim Zurückgeben von SVGPointList.length ergibt sich der Wert 5. Nach dem Aufruf von initialize() ergibt das Zurückgeben von SVGPointList.length den Wert 1.

html
<svg id="svg" viewBox="-10 -10 120 120" xmlns="http://www.w3.org/2000/svg">
  <polyline
    id="example"
    stroke="black"
    fill="none"
    points="50,0 21,90 98,35 2,35 79,90" />
</svg>
js
const example = document.getElementById("example");
console.log(example.points.length); // 5;
const point = document.getElementById("svg").createSVGPoint();
example.points.initialize(point);
console.log(example.points.length); // 1

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__initialize

Browser-Kompatibilität