浏览器与 Web API / 系统课时
className 与 classList
className 与 classList
本课解决如何在不破坏现有样式的前提下管理 CSS 类名。你将理解 className 的整体覆盖特性,并使用 classList 的五个常用方法完成稳定、可预测的样式状态切换。
学习目标
- 区分
className整体赋值与classList局部操作 - 使用五个常用方法管理元素类名
- 根据明确状态选择合适的切换写法
接口选择与常用方法
className 是字符串属性,读取时得到完整类名文本,赋值时会一次替换全部类名。它适合明确重建整个类名集合,但在组件已有基础类、尺寸类和状态类时,直接赋值容易误删其他样式。
classList 返回一个 DOMTokenList,可以把每个类名作为独立标记处理。它不会因为添加或删除一个状态类而重写其余类名,因此更适合交互状态管理。
| 需求 | 推荐接口 | 原因 |
|---|---|---|
| 一次设置完整类名 | className |
目标字符串明确,写法直接 |
| 添加或删除单个类 | classList |
不影响其他类名 |
| 判断类是否存在 | classList.contains() |
返回布尔值,语义清楚 |
| 根据状态切换类 | classList.toggle() |
可反转,也可显式控制 |
add() 可添加一个或多个类,重复添加不会产生副本;remove() 删除指定类,类不存在时也不会报错;contains() 返回类是否存在。toggle() 可反转类状态,也可通过第二个布尔参数指定最终状态;replace() 只在旧类存在时替换,并返回是否成功。
完整状态管理示例
下面的代码可直接在浏览器控制台执行。它创建一个按钮,并依次演示添加、删除、显式切换、替换、判断和反转切换。
document.body.innerHTML =
'<button id="saveButton" class="btn btn-primary">保存</button>';
const button = document.querySelector("#saveButton");
console.log(button.className);
// 局部修改类名,保留未被操作的其他类
button.classList.add("is-loading");
button.classList.remove("btn-primary");
button.classList.toggle("is-active", true);
button.classList.replace("btn", "button");
console.log([...button.classList].join(" "));
console.log(button.classList.contains("is-active"));
// 单参数 toggle 会反转当前状态
button.classList.toggle("is-active");
console.log(button.className);预期输出:
btn btn-primary
button is-loading is-active
true
button is-loading示例先把基础类 btn 替换为 button,再通过无第二参数的 toggle() 删除已经存在的 is-active。类名的显示顺序通常与插入顺序一致,但业务逻辑不应依赖字符串顺序,而应使用 contains() 判断状态。
显式状态与关键边界
处理渲染函数、网络请求或表单校验时,代码通常已经知道目标状态。此时应使用 toggle(name, force),避免函数重复执行时把状态意外反转。
const card = document.createElement("article");
function setSelected(isSelected) {
// 第二个参数表达最终状态,重复调用仍然稳定
card.classList.toggle("is-selected", isSelected);
}
// 重复设置 true 不会把类名切回关闭状态
setSelected(true);
setSelected(true);
console.log(card.classList.contains("is-selected"));
setSelected(false);
console.log(card.classList.contains("is-selected"));预期输出:
true
false类名参数必须是单个合法标记,不能把 "btn active" 作为一个参数传给 add()。添加多个类应写成 element.classList.add("btn", "active")。只有确实要重建全部类名时才使用 className;修改加载、选中、禁用等独立状态时,优先使用 classList。