SVGPointList: replaceItem()-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 replaceItem()-Methode der SVGPointList-Schnittstelle ersetzt einen point in der Liste.

Syntax

js
replaceItem(obj, index)

Parameter

obj

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

index

Der Index des zu ersetzenden Elements.

Rückgabewert

Das neue SVGPoint-Objekt.

Ausnahmen

NoModificationAllowedError DOMException

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

IndexSizeError DOMException

Wird ausgelöst, wenn der übergebene Index größer ist als die Anzahl der Elemente in der Liste.

Beispiele

Das folgende Beispiel zeigt ein SVG, das ein <polyline> mit fünf Koordinatenpaaren enthält. Ein neues SVGPoint wird erstellt und ersetzt dann den Punkt an Index 1 (das zweite Element in der Liste).

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.replaceItem(svgPoint, 1));

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__replaceItem

Browser-Kompatibilität

BCD tables only load in the browser