SVGPointList: insertItemBefore() Methode

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 Methode insertItemBefore() der SVGPointList-Schnittstelle fügt ein DOMPoint vor einem anderen Element in der Liste ein.

Syntax

js
insertItemBefore(obj, index)

Parameter

obj

Ein DOMPoint-Objekt, das die Koordinaten des einzufügenden Punktes enthält.

index

Der Index des Elements, vor dem das Objekt eingefügt werden soll. Wenn der angegebene Index größer als die Länge der Liste ist, wird der Index auf die Listenlänge gesetzt und das Element wird vor dem letzten Element in der Liste eingefügt.

Rückgabewert

Das eingefügte DOMPoint-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. Ein neuer DOMPoint wird erstellt und vor dem Punkt bei Index 2 eingefügt.

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");
const point = document.getElementById("svg").createSVGPoint();
point.y = 10;
point.x = 10;
console.log(example.points.insertItemBefore(point, 2));

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__insertItemBefore

Browser-Kompatibilität