MDN self-hosted library · e01.org

SVGPointList: replaceItem() method

SVG

SVG

The replaceItem() method of the SVGPointList interface replaces a DOMPoint in the list.

Assigning to an index of the list has the same effect as calling this method, except that there is no return value.

Syntax

replaceItem(obj, index)

Parameters

  • obj
  • : A DOMPoint object containing the coordinates of the point to be inserted.
  • index
  • : The index of the item to replace.

Return value

The new DOMPoint object.

Exceptions

  • NoModificationAllowedError DOMException
  • : Thrown if the list is read-only.
  • IndexSizeError DOMException
  • : Thrown if the index passed in is greater than the number of items in the list.

Examples

The following example shows an SVG which contains a polyline with five coordinate pairs. A new DOMPoint is created, then replaces the point at index 1 (the second item in the list).

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

Specifications

Browser compatibility