SVGLengthList: insertItemBefore() メソッド

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.

insertItemBefore() は SVGLengthList インターフェイスのメソッドで、指定した位置に新しいアイテムをリストに挿入します。最初のアイテムのインデックスは 0 です。挿入されるアイテムはアイテムそのものであり、コピーではありません。

  • 新しいアイテムがすでにリスト内にある場合、このリストに挿入される前に、前回あったリストから除去されます。
  • アイテムがすでにこのリスト内にある場合、挿入するアイテムの位置は、アイテムが除去される前の時点のものであることに注意してください。
  • 位置が 0 である場合、新しいアイテムはリストの先頭に挿入されます。
  • 位置が length 以上である場合、新しいアイテムはリストの末尾に追加されます。

構文

js
insertItemBefore(newItem, index)

引数

newItem

リストに追加する SVGLength です。

index

新しいアイテムを直前の位置に挿入するアイテムのインデックスを指定する非負の整数です。

返値

リストに追加された SVGLength です。

例外

DOMException NoModificationAllowedError

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

例

完全な例については SVGLengthList を参照してください。

仕様書

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__insertItemBefore

ブラウザーの互換性