SVGStringList

SVG 字符串列表接口

SVGStringList 定义了一个字符串列表。

一个 SVGStringList 对象可以被指定为只读，这意味着尝试修改该对象将导致抛出异常。

接口概述

也实现	无
方法	`void clear()` string `initialize(string newItem)` string `getItem(number index)` string `insertItemBefore(string newItem, number index)` string `replaceItem(string newItem, number index)` string `removeItem(number index)` string `appendItem(string newItem)`
属性	readonly unsigned long `numberOfItems` readonly unsigned long `length` 非标准
规范性文档	SVG 1.1（第二版）

实例属性

名称	类型	描述
`numberOfItems`	`unsigned long`	列表中的项目数量。
`length`	`unsigned long`	与 `numberOfItems` 中的值镜像，以与其他接口保持一致。非标准

实例方法

名称和参数	返回	描述
`clear()`	void	清除列表中所有现有的当前项目，结果为空列表。异常当列表对应于只读属性或对象本身是只读时，将引发代码为 `NO_MODIFICATION_ALLOWED_ERR` 的 `DOMException`。
`initialize(string newItem)`	string	清除列表中所有现有的当前项目，并重新初始化列表以保存参数指定的单个项目。如果插入的项目已在列表中，则在将其插入此列表之前，将其从以前的列表中删除。插入的项目是项目本身，而不是副本。返回值是插入列表中的项目。异常当列表对应于只读属性或对象本身是只读时，将引发代码为 `NO_MODIFICATION_ALLOWED_ERR` 的 `DOMException`。
`getItem(number index)`	string	返回列表中的指定项目。返回的项目是项目本身，而不是副本。对项目所做的任何更改都会立即反映在列表中。第一个项目是编号 0。异常当列表对应于只读属性或对象本身是只读时，将引发代码为 `NO_MODIFICATION_ALLOWED_ERR` 的 `DOMException`。
`insertItemBefore(string newItem, number index)`	string	在指定位置将新项目插入列表中。第一个项目是编号 0。如果 `newItem` 已在列表中，则在将其插入此列表之前，将其从以前的列表中删除。插入的项目是项目本身，而不是副本。如果该项目已在此列表中，请注意，在删除项目之前，要插入之前的项目索引。如果 `index` 等于 0，则将新项目插入列表的开头。如果索引大于或等于 `numberOfItems`，则将新项目追加到列表的末尾。异常当列表对应于只读属性或对象本身是只读时，将引发代码为 `NO_MODIFICATION_ALLOWED_ERR` 的 `DOMException`。
`replaceItem(string newItem, number index)`	string	用新项目替换列表中的现有项目。如果 `newItem` 已在列表中，则在将其插入此列表之前，将其从以前的列表中删除。插入的项目是项目本身，而不是副本。如果该项目已在此列表中，请注意，在删除项目之前，要替换的项目索引。异常当列表对应于只读属性或对象本身是只读时，将引发代码为 `NO_MODIFICATION_ALLOWED_ERR` 的 `DOMException`。如果索引号大于或等于 `numberOfItems`，则将引发代码为 `INDEX_SIZE_ERR` 的 `DOMException`。
`removeItem(in unsigned long index)`	string	从列表中删除现有项目。异常当列表对应于只读属性或对象本身是只读时，将引发代码为 `NO_MODIFICATION_ALLOWED_ERR` 的 `DOMException`。如果索引号大于或等于 `numberOfItems`，则将引发代码为 `INDEX_SIZE_ERR` 的 `DOMException`。
`appendItem(string newItem)`	string	在列表末尾插入新项目。如果 `newItem` 已在列表中，则在将其插入此列表之前，将其从以前的列表中删除。插入的项目是项目本身，而不是副本。异常当列表对应于只读属性或对象本身是只读时，将引发代码为 `NO_MODIFICATION_ALLOWED_ERR` 的 `DOMException`。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。