SVGLengthList

SVG 长度列表接口

SVGLengthList 定义了一个 SVGLength 对象列表。

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

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

接口概述

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

浏览器兼容性

BCD 表格仅在浏览器中加载