DOMTokenList: add() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

DOMTokenList 介面的 add() 方法將給定的 token 新增到列表中,忽略任何已經存在的 token。

語法

js
add(token1)
add(token1, token2)
add(token1, token2, /* …, */ tokenN)

引數

tokenN

一個代表要新增到 DOMTokenList 的 token(或 tokens)的字串。

返回值

無。

異常

SyntaxError DOMException

如果其中一個引數為空字串,則丟擲此異常

InvalidCharacterError DOMException

如果 token 包含 ASCII 空白符,則丟擲此異常

示例

在以下示例中,我們使用 Element.classList 檢索設定在 <span> 元素上的類列表,該列表為一個 DOMTokenList。然後,我們將一個新 token 新增到列表中,並將該列表寫入 <span>Node.textContent

首先,HTML 程式碼

html
<span class="a b c"></span>

現在是 JavaScript 程式碼

js
const span = document.querySelector("span");
const classes = span.classList;
classes.add("d");
span.textContent = classes;

輸出如下所示

您也可以新增多個 token

js
span.classList.add("d", "e", "f");

規範

規範
DOM
# ref-for-dom-domtokenlist-add①

瀏覽器相容性