HTML DOM classList 属性

语法

element.classList

描述

classList 属性返回元素的类名，为 DOMTokenList 对象。

该属性用于在元素中添加，移除及切换 CSS 类。

classList 属性是只读的，但你可以使用 add() 和 remove() 方法修改它。

参数

属性	描述
length	返回类列表中类的数量 该属性是只读的

方法	描述
add(class1, class2, …)	在元素中添加一个或多个类名。 如果指定的类名已存在，则不会添加
contains(class)	返回布尔值，判断指定的类名是否存在。 可能值： true – 元素包已经包含了该类名 false – 元素中不存在该类名
item(index)	返回元素中索引值对应的类名。索引值从 0 开始。 如果索引值在区间范围外则返回 null
remove(class1, class2, …)	移除元素中一个或多个类名。 注意： 移除不存在的类名，不会报错。
toggle(class, true|false)	在元素中切换类名。 第一个参数为要在元素中移除的类名，并返回 false。 如果该类名不存在则会在元素中添加类名，并返回 true。 第二个是可选参数，是个布尔值用于设置元素是否强制添加或移除类，不管该类名是否存在。例如： 移除一个 class: element.classList.toggle(“classToRemove”, false); 添加一个 class: element.classList.toggle(“classToAdd”, true); 注意： Internet Explorer 或 Opera 12 及其更早版本不支持第二个参数。

返回值

一个 DOMTokenList, 包含元素的类名列表。

划重点

实例

为 <div> 元素添加多个类:

document.getElementById("maosiji").classList.add("zhuti", "chajian", "wordpress");

为 <div> 元素移除一个类:

document.getElementById("maosiji").classList.remove("zhuti");

获取 <div> 元素的类名:

var x = document.getElementById("maosiji").classList;

查看 <div> 元素有多少个类名:

var x = document.getElementById("maosiji").classList.length;

查看元素是否存在 “mao” 类:

var x = document.getElementById("maosiji").classList.contains("mao");

为 <div> 元素切换类:

document.getElementById("maosiji").classList.toggle("newClass");