Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

SVGPointList

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die SVGPointList-Schnittstelle stellt eine Liste von DOMPoint-Objekten dar.

Eine SVGPointList kann als schreibgeschützt festgelegt werden. Das bedeutet, dass Versuche, das Objekt zu ändern, eine Ausnahme auslösen.

Ein SVGPointList-Objekt ist indexierbar und kann wie ein Array über die Klammernotation aufgerufen werden. Das Lesen eines Index entspricht dem Aufruf von getItem(). Das Zuweisen zu einem Index entspricht dem Aufruf von replaceItem(), einschließlich der dabei ausgelösten Ausnahmen.

Instanzeigenschaften

SVGPointList.length Schreibgeschützt

Gibt die Anzahl der Punkte in der Liste zurück.

SVGPointList.numberOfItems Schreibgeschützt

Gibt die Anzahl der Punkte in der Liste zurück.

Instanzmethoden

SVGPointList.clear()

Entfernt alle Elemente aus der Liste.

SVGPointList.initialize()

Entfernt zunächst alle Elemente aus der Liste und fügt dann der Liste einen einzelnen Wert hinzu.

SVGPointList.getItem()

Ruft ein Element an einer angegebenen Position aus der Liste ab.

SVGPointList.insertItemBefore()

Fügt ein Element an einer angegebenen Position in die Liste ein.

SVGPointList.replaceItem()

Ersetzt ein Element in der Liste durch ein neues Element.

SVGPointList.removeItem()

Entfernt ein Element aus der Liste.

SVGPointList.appendItem()

Fügt ein Element am Ende der Liste hinzu.

Beispiele

Das folgende Beispiel zeigt ein SVG, das ein <polyline> mit fünf Koordinatenpaaren enthält. Die Eigenschaft points gibt eine SVGPointList zurück.

html
<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); // An SVGPointList

Spezifikationen

Spezifikation
Scalable Vector Graphics (SVG) 2
# InterfaceSVGPointList

Browser-Kompatibilität