SVGStringList: insertItemBefore() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
insertItemBefore() は SVGStringList インターフェイスのメソッドで、指定した位置に新しいアイテムをリストに挿入します。最初のアイテムのインデックスは 0 です。挿入されるアイテムはアイテムそのものであり、コピーではありません。
- 新しいアイテムがすでにリスト内にある場合、このリストに挿入される前に、前回あったリストから除去されます。
- アイテムがすでにこのリスト内にある場合、挿入するアイテムの位置は、アイテムが除去される前の時点のものであることに注意してください。
- 位置が 0 である場合、新しいアイテムはリストの先頭に挿入されます。
- 位置が
length以上である場合、新しいアイテムはリストの末尾に追加されます。
構文
js
insertItemBefore(newItem, index)
引数
返値
リストに追加された文字列です。
例外
DOMExceptionNoModificationAllowedError-
SVGStringListが読み取り専用属性に対応するか、オブジェクト自体が読み取り専用であった場合に発生します。
仕様書
| 仕様書 |
|---|
| Scalable Vector Graphics (SVG) 2 # __svg__SVGNameList__insertItemBefore |