DOMTokenList: add() メソッド

tokenN

DOMTokenList に追加するトークン（またはトークン群）を表す文字列です。

なし。

SyntaxError DOMException

引数のうちの 1 つが空文字列であった場合に発生します。

InvalidCharacterError DOMException

トークンに ASCII ホワイトスペースが含まれていた場合に発生します。

以下の例では、 <span> 要素に設定されたクラスのリストを DOMTokenList として受け取るのに Element.classList を使用しています。それからリストに新しいトークンを追加し、リストを <span> の Node.textContent に書き込みます。

最初に HTML です。

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

そして JavaScript です。

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

出力結果は以下のようになります。

同様に、複数のトークンを追加することができます。

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