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

Element.classList

· 52CE 我爱测

`Element.classList`** 是一个只读属性,返回一个元素 `class` 属性的动态 DOMTokenList 集合。这可以用于操作 class 集合。

DOM

Element.classList 是一个只读属性,返回一个元素 class 属性的动态 DOMTokenList 集合。这可以用于操作 class 集合。

相比将 element.className 作为以空格分隔的字符串来使用,classList 是一种更方便的访问元素的类列表的方法。

值

一个 DOMTokenList,表示元素的 class 属性的集合。如果 class 属性没有设置或者为空,它将返回一个空的 DOMTokenList,即 length 属性等于 0 的 DOMTokenList。

尽管 classList 属性自身是只读的,但是你可以使用 DOMTokenList/add、DOMTokenList/remove、DOMTokenList/replace 和 DOMTokenList/toggle 方法修改其关联的 DOMTokenList。

示例

const div = document.createElement("div");
div.className = "foo";

// 初始状态:<div class="foo"></div>
console.log(div.outerHTML);

// 使用 classList API 移除、添加类值
div.classList.remove("foo");
div.classList.add("anotherclass");

// <div class="anotherclass"></div>
console.log(div.outerHTML);

// 如果 visible 类值已存在,则移除它,否则添加它
div.classList.toggle("visible");

// add/remove visible, depending on test conditional, i less than 10
div.classList.toggle("visible", i < 10);

console.log(div.classList.contains("foo"));

// 添加或移除多个类值
div.classList.add("foo", "bar", "baz");
div.classList.remove("foo", "bar", "baz");

// 使用展开语法添加或移除多个类值
const cls = ["foo", "bar"];
div.classList.add(...cls);
div.classList.remove(...cls);

// 将类值 "foo" 替换成 "bar"
div.classList.replace("foo", "bar");

[!NOTE] Firefox 26 之前的版本没有在 add/remove/toggle 实现使用多个参数。参见 https://bugzilla.mozilla.org/show_bug.cgi?id=814014

规范

浏览器兼容性

参考

  • element.className
  • DOMTokenList
  • classList.js (a cross-browser JavaScript polyfill that fully implements element.classList)

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

资料来源与适用范围

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

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

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