浏览器与 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() 只在旧类存在时替换,并返回是否成功。

完整状态管理示例

下面的代码可直接在浏览器控制台执行。它创建一个按钮,并依次演示添加、删除、显式切换、替换、判断和反转切换。

js
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);

预期输出:

text
btn btn-primary
button is-loading is-active
true
button is-loading

示例先把基础类 btn 替换为 button,再通过无第二参数的 toggle() 删除已经存在的 is-active。类名的显示顺序通常与插入顺序一致,但业务逻辑不应依赖字符串顺序,而应使用 contains() 判断状态。

显式状态与关键边界

处理渲染函数、网络请求或表单校验时,代码通常已经知道目标状态。此时应使用 toggle(name, force),避免函数重复执行时把状态意外反转。

js
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"));

预期输出:

text
true
false

类名参数必须是单个合法标记,不能把 "btn active" 作为一个参数传给 add()。添加多个类应写成 element.classList.add("btn", "active")。只有确实要重建全部类名时才使用 className;修改加载、选中、禁用等独立状态时,优先使用 classList。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

className 与 classList

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通