SVGStringList:insertItemBefore() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

SVGStringList 介面的 insertItemBefore() 方法會在指定的 Posi tion 插入一個新項。第一個 Posi tion 的索引為 0。插入的項是項本身,而不是副本。

  • 如果新項已在列表中,則在插入到此列表之前,它將從其先前的列表中移除。
  • 如果該項已在此列表中,請注意,要插入該項之前的索引是在該項被移除之前的索引。
  • 如果索引為 0,則新項將插入到列表的開頭。
  • 如果 Posi tion 大於或等於 length,則新項將被新增到列表的末尾。

語法

js
insertItemBefore(newItem, index)

引數

newItem

要新增到列表中的字串。

index

一個非負整數,指定要插入新項之前的項的索引。

返回值

已新增到列表中的字串。

異常

NoModificationAllowedError DOMException

如果 SVGStringList 對應於只讀屬性或物件本身是隻讀的,則會丟擲此錯誤。

規範

規範
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__insertItemBefore

瀏覽器相容性