在 JavaScript 與各種函式庫裡打滾多年,我常有這樣的念頭:什麼時候瀏覽器才會原生提供一套輔助方法,讓我們不必再為了「加一個 class」而引入 jQuery?這個願望正在逐步實現,而 classList 就是其中一個已經落地的例子。
在 HTML5 API 中,DOM 裡的每個節點都帶有一個 classList 物件,開發者可以用它新增、刪除、修改節點上的 CSS 類,也能判斷某個節點是否已被賦予某個類。
{
length: {number}, /* 該元素上的 class 數量 */
add: function() { [native code] },
contains:function() { [native code] },
item: function() { [native code] }, /* 依索引取得 */
remove: function() { [native code] },
toggle: function() { [native code] }
}
這個物件很小,但每個方法都剛好解決了過去最麻煩的那幾件事。
myDiv.classList.add('myCssClass');
myDiv.classList.remove('myCssClass');
這個方法可以一次傳入多個類名並以空格分隔,但實際執行的結果未必如你所預期,因此建議一次處理一個。
myDiv.classList.toggle('myCssClass'); // 現在是增加
myDiv.classList.toggle('myCssClass'); // 現在是刪除
有就移除、沒有就加入——這個「切換」語意正是做開關效果最需要的。在過去,我們得先 className.indexOf() 判斷,再決定要 append 還是 replace,程式碼又長又容易出錯。
myDiv.classList.contains('myCssClass'); // 回傳 true 或 false
過去要操作 class,只能反覆做字串處理:讀出 element.className、用正則或 indexOf 搜尋、拼接、再寫回去。這個流程不只冗長,還有一堆邊界情況——前後空白、重複的類名、大小寫、多個元素要一次處理等等,每個都是 bug 的溫床。
classList 把這些細節全部收進 API 裡。目前主流現代瀏覽器都已支援,因此新型 JavaScript 函式庫幾乎都改用 classList 實作,不再需要解析 class 屬性字串。
補充一個實務技巧:classList 是可迭代的,你可以直接用 forEach 遍歷所有類名;另外它還有 replace(old, new) 與 item(index) 兩個方法,在動畫切換與動態樣式組裝時很順手。