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

浏览器兼容性