HTML DOM classList 屬性

元素對象參考手冊 元素對象

實例

為 <div> 元素添加 class:

document.getElementById("myDIV").classList.add("mystyle");

定義和用法

classList 屬性返回元素的類名，作為 DOMTokenList 對象。

該屬性用於在元素中添加，移除及切換 CSS 類。

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

流覽器支持

表格中的數字表示支持該屬性的第一個流覽器的版本號。

屬性
classList 8.0 10.0 3.6 5.1 11.5

語法

element.classList

Properties

屬性 Description
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("myDIV").classList.add("mystyle", "anotherClass", "thirdClass");


實例

為 <div> 元素移除一個類:

document.getElementById("myDIV").classList.remove("mystyle");


實例

為 <div> 元素移除多個類:

document.getElementById("myDIV").classList.remove("mystyle", "anotherClass", "thirdClass");


實例

為 <div> 元素切換類:

document.getElementById("myDIV").classList.toggle("newClassName");


實例

獲取 <div> 元素的類名:

<div id="myDIV" class="mystyle anotherClass thirdClass">I am a DIV element</div>

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

x 輸出結果為:

mystyle anotherClass thirdClass


實例

查看 <div> 元素有多少個類名:

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

x 輸出結果為:

3


實例

獲取 <div> 元素的第一個類名（索引為0）:

var x = document.getElementById("myDIV").classList.item(0);

x 輸出結果為:

mystyle


實例

查看元素是否存在 "mystyle" 類:

var x = document.getElementById("myDIV").classList.contains("mystyle");

x 輸出結果為:

true


實例

查看元素是否存在 "mystyle" 類，如果存在則移除另外一個類名:

var x = document.getElementById("myDIV");

if (x.classList.contains("mystyle")) {
    x.classList.remove("anotherClass");
} else {
    alert("Could not find it.");
}

相關文章

CSS 教學: CSS 選擇器

CSS 參考手冊: CSS .class 選擇器

HTML DOM 參考手冊: HTML DOM className 屬性

HTML DOM 參考手冊: HTML DOM getElementsByClassName() 方法

HTML DOM 參考手冊: HTML DOM Style 對象

元素對象參考手冊 元素對象