DOMTokenList.add()

DOMTokenList インターフェイスの add() メソッドは、指定されたトークンをリストに追加します。

構文

tokenList.add(token1[, token2[, ...]]);

引数

tokenN
リストに追加したいトークンを表す DOMString です。

返値

なし。

例

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

最初に HTML です。

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

そして JavaScript です。

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

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

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

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

仕様策定状況

仕様書 策定状況 コメント
DOM
add() の定義		 現行の標準 初回定義

ブラウザーの対応

BCD tables only load in the browser