SVGNumberList

SVG 数字列表接口

SVGNumberList 定义了一个 SVGNumber 对象列表。

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

SVGNumberList 是可索引的，可以像数组一样访问。

接口概述

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

实例属性

名称	类型	描述
`numberOfItems`	unsigned long	列表中项目的数量。
`length` 非标准	unsigned long	列表中项目的数量。

实例方法

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

浏览器兼容性

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