大网数据广告活动
Web 标准与前端开发

DOMTokenList

· 52CE 我爱测

**`DOMTokenList`** 接口表示一组空格分隔的标记(tokens)。如由 Element.classList、HTMLLinkElement.relList、HTMLAnchorElement.relList 或 HTMLAreaElement.relList 返回的一组值。它和 JavaScript Array 对象一样,索引从 0 开始。`DOMTokenList` 总是区分大小写(case-sensitive)。

DOMTokenList 接口表示一组空格分隔的标记(tokens)。如由 Element.classList、HTMLLinkElement.relList、HTMLAnchorElement.relList 或 HTMLAreaElement.relList 返回的一组值。它和 JavaScript Array 对象一样,索引从 0 开始。DOMTokenList 总是区分大小写(case-sensitive)。

属性

  • DOMTokenList.length
    • : 一个整数,表示存储在该对象里值的个数。
  • DOMTokenList.value
    • : 该属性以 String 的形式返回 DOMTokenList 列表的值。

方法

  • DOMTokenList.item()
    • : 根据传入的索引值返回一个值,如果索引值大于等于符号列表的长度(length),则返回 undefined 或 null,在 Gecko 7.0 之前的版本中返回 null。
  • DOMTokenList.contains()
    • : 如果 DOMTokenList 列表中包括相应的字符串 token,则返回 true,否则返回 false。
  • DOMTokenList.add()
    • : 添加一个或多个标记(token)到 DOMTokenList 列表中。
  • DOMTokenList.remove()
    • : 从 DOMTokenList 列表中移除一个或多个标记(token)。
  • DOMTokenList.replace()
    • : 使用 newToken 替换 token_ 。_
  • DOMTokenList.supports()
    • : 如果传入的 token 是相关属性(attribute)支持的标记,则返回 true 。
  • DOMTokenList.toggle()
    • : 从 DOMTokenList 字符串中移除标记字串(token),并返回 false。如果传入的字串(token)不存在,则将其添加进去,并返回 true 。force 是一个可选的布尔值,如果传入 true ,且传入的 token 不存在,则将其添加进去并返回 true ,若传入的 token 存在,则直接返回 true ;反之,如果传入 false ,则移除存在的 token,并返回 false ,如 token 不存在则直接返回 false 。
  • DOMTokenList.entries()
    • : 返回一个迭代器(Iteration_protocols),以遍历这个对象中的所有键值对。
  • DOMTokenList.forEach()
    • : 为每个 DOMTokenList 中的元素都调用一次传入的 callback 函数。
  • DOMTokenList.keys()
    • : 返回一个迭代器(Iteration_protocols)以遍历这个对象中所有键值对的键。
  • DOMTokenList.values()
    • : 返回一个迭代器(Iteration_protocols)以遍历这个对象中所有键值对的值。

示例

在下面这个简单的例子中,我们使用 Element.classList 获取了 p 元素的 class 列表,也就是一个DOMTokenList ,再使用 DOMTokenList.add() 添加了一个 class,然后更新 <p> 元素的Node.textContent以显示这个新的 DOMTokenList。

HTML

<p class="a b c"></p>

JavaScript

let para = document.querySelector("p");
let classes = para.classList;
para.classList.add("d");
para.textContent = `paragraph classList is "${classes}"`;

输出类似这样:

示例

去除空格和重复项目

修改 DOMTokenList 的方法(例如 DOMTokenList.add())会自动去除多余的空格(Whitespace)和列表中的重复项目。例如:

<span class="    d   d e f"></span>
let span = document.querySelector("span");
let classes = span.classList;
span.classList.add("x");
span.textContent = `span classList is "${classes}"`;

输出类似这样:

去除空格和重复项目

规范

浏览器兼容性

参见

  • DOMSettableTokenList (object that extends DOMTokenList with settable .value property)
  • Firefox bug 501257 - Implement HTML 5's HTMLElement.classList property

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。