SVGPointList: replaceItem() メソッド

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.

replaceItem()SVGPointList インターフェイスのメソッドで、リスト内のを置き換えます。

構文

js
replaceItem(obj, index)

引数

obj

挿入する点の座標が入った SVGPoint オブジェクトです。

index

置き換えるアイテムのインデックスです。

返値

新しい SVGPoint オブジェクトです。

例外

NoModificationAllowedError DOMException

リストが読み取り専用である場合に発生します。

IndexSizeError DOMException

渡されたインデックスがリスト内のアイテムの数よりも大きい場合に発生します。

次の例では、 SVG の中に 5 つの座標ペアを持つ <polyline> があります。新しい SVGPoint を作成し、インデックス 1 (リストの内 2 つ目のアイテム)の点を置き換えます。

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));

仕様書

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__replaceItem

ブラウザーの互換性