SVGPointList: initialize() Methode

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.

Die initialize() Methode der SVGPointList Schnittstelle leert die Liste und fügt dann ein einziges neues SVGPoint Objekt der Liste hinzu.

Syntax

js
initialize(obj)

Parameter

obj

Ein SVGPoint Objekt, das die Koordinaten des Punktes enthält, der hinzugefügt wird, wenn die Liste initialisiert wird.

Rückgabewert

Das hinzugefügte SVGPoint Objekt.

Ausnahmen

NoModificationAllowedError DOMException

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

Beispiele

Das folgende Beispiel zeigt ein SVG, das eine <polyline> mit fünf Koordinatenpaaren enthält. Die Rückgabe von SVGPointList.length ergibt den Wert 5. Nach dem Aufruf von initialize(), ergibt die Rückgabe 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 svgPoint = document.getElementById("svg").createSVGPoint();
example.points.initialize(svgPoint);
console.log(example.points.length); // 1

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__initialize

Browser-Kompatibilität