DOMTokenList:item() 方法

item() 方法是 DOMTokenList 接口的方法,它根据列表中的位置(即索引)返回列表中的某个项目。

注意:此方法等效于 方括号表示法。因此,aList.item(i)aList[i] 相同。

语法

js
tokenList.item(index)

参数

index

一个表示要返回的项目的索引的数字。如果它不是整数,则只考虑整数部分。

返回值

一个表示返回项目的字符串,或者如果数字大于或等于列表的 length,则返回 null

异常

TypeError

如果 index 无法转换为整数,则抛出此异常。

示例

在以下示例中,我们使用 Element.classList 将设置在 <span> 元素上的类列表作为 DOMTokenList 获取。然后,我们使用 item(tokenList.length - 1) 获取列表中的最后一个项目,并将其写入 <span>Node.textContent 中。

首先,HTML 代码

html
<span class="a b c"></span>

现在是 JavaScript 代码

js
const span = document.querySelector("span");
const classes = span.classList;
const item = classes.item(classes.length - 1);
span.textContent = item;

输出结果如下所示

规范

规范
DOM 标准
# ref-for-dom-domtokenlist-item①

浏览器兼容性

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