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 January 2020.

Die insertItemBefore() Methode des SVGPointList Interfaces fügt einen point vor einem anderen Element in der Liste ein.

Syntax

js
insertItemBefore(obj, index)

Parameter

obj

Ein SVGPoint-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 übergebene 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 der Liste eingefügt.

Rückgabewert

Das eingefügte SVGPoint-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. Ein neuer SVGPoint wird erstellt und vor dem Punkt mit dem 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
let example = document.getElementById("example");
let svgPoint = document.getElementById("svg").createSVGPoint();
svgPoint.y = 10;
svgPoint.x = 10;
console.log(example.points.insertItemBefore(svgPoint, 2));

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__insertItemBefore

Browser-Kompatibilität

BCD tables only load in the browser