HOWTO · JavaScript
在 JavaScript 中更改 CSS 类
学习如何使用 className 和 classList 更改元素的 CSS 类,并包含一个由点击驱动的示例。
本页内容
要使用 JavaScript 更改元素的外观,请先选中该元素并更新其类。当需要替换整个类属性时,给 className 赋值;当需要添加、移除或替换单个类标记同时保留其他类时,使用 classList。点击监听器可以让更改响应读者的操作而发生。
在 JavaScript 中更改 CSS 类的各种方法
下面的完整页面为 div 设置了 ID dimensions,并使用 CSS 类来控制其大小和背景。初始类 bg_1 设置深红色背景。点击该元素会移除这个类并添加 bg_2,后者设置蓝绿色背景。你可以将该页面保存为 HTML 文件并在浏览器中打开,以查看过渡效果。
使用 className 属性
className 是一个属性,而不是方法。给它赋一个字符串会替换元素的整个类属性。例如,将其设置为 "dimensions bg_2" 会更改背景并保留尺寸类。如果只设置为 "bg_2",dimensions 也会被移除,因此请包含元素应保留的每一个类。当需要有意定义完整的类集合(例如一次性应用一组已知的状态类)时,这种方法很有用。
使用 classList.remove 和 classList.add
classList 是一个属性,它提供了用于编辑单个类标记的方法。调用 classList.remove("bg_1") 和 classList.add("bg_2") 可以更改背景类,而不会影响 dimensions 或其他无关的类。add 不会重复添加已经存在的标记,remove 只影响被指名的标记。当元素上有应该保留原位的类(包括由页面其他行为添加的类)时,使用这些操作。
使用 classList.replace() 方法
classList.replace("bg_1", "bg_2") 会将一个标记替换为另一个标记,并保持其他类不变。只有当 bg_1 存在时才会发生替换;当旧标记不存在时,不会更改任何标记。当一个类状态直接映射到另一个类状态时,选择这种方法。当你希望让两个操作更明确,或者处理程序在两个操作之间还有其他工作要完成时,分别调用 remove 和 add 很有用。
下面是一个完整的 HTML 页面,包括其样式、元素和点击处理程序。末尾的小型 JavaScript 适配器模拟了相同的页面交互,使该示例也能得到确定的控制台结果;在浏览器中,页面内联脚本会处理真实的点击。
const html = `<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Change a CSS class</title>
<style>
.dimensions { width: 200px; height: 100px; }
.bg_1 { background-color: crimson; }
.bg_2 { background-color: teal; }
</style>
</head>
<body>
<div id="dimensions" class="dimensions bg_1">Click this box</div>
<script>
const element = document.getElementById("dimensions");
element.addEventListener("click", () => {
element.classList.remove("bg_1");
element.classList.add("bg_2");
});
</script>
</body>
</html>`;
const element = {
className: "dimensions bg_1",
addEventListener(type, handler) {
this.handler = handler;
},
classList: {
remove(token) {
element.className = element.className
.split(" ")
.filter((name) => name !== token)
.join(" ");
},
add(token) {
const names = element.className.split(" ");
if (!names.includes(token)) names.push(token);
element.className = names.join(" ");
}
}
};
const document = { getElementById: () => element };
const selected = document.getElementById("dimensions");
selected.addEventListener("click", () => {
selected.classList.remove("bg_1");
selected.classList.add("bg_2");
});
selected.handler();
console.log(selected.className);
dimensions bg_2
浏览器部分展示了真实的 DOM 模式:document.getElementById("dimensions") 返回该元素,addEventListener 注册在点击时运行的回调。Node.js 默认不提供页面的 DOM,因此 Node.js 适配器为控制台输出再现了类标记的更改。可见的颜色由样式表决定;仅更改类名本身不会产生视觉效果,除非存在匹配的 CSS 规则。如需直接整体替换,请使用 className 并列出要保留的每个类。如需有针对性地更改且不触及尺寸、布局和无关状态类,请使用 classList 的方法。如果处理程序似乎不起作用,请检查 ID 是否匹配,以及两个背景类是否都在页面的样式表中定义。