DOMTokenList: remove() メソッド
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
remove()
は DOMTokenList
インターフェイスのメソッドで、リストから指定されたトークンを取り除きます。
構文
js
remove(token1)
remove(token1, token2)
remove(token1, token2, /* … ,*/ tokenN)
引数
token1
, …,tokenN
-
リストから取り除きたいトークンを表す文字列です。 文字列がリストにない場合は、エラーは発生せず、何も起こりません。
返値
なし (undefined
)。
例
以下の例では、 <span>
要素に設定されたクラスのリストを、 DOMTokenList
として受け取るのに Element.classList
を使用します。それからリストからトークンを取り除き、 <span>
の Node.textContent
の中にリストを書き込みます。
最初に HTML です。
html
<div id="ab" class="a b c"></div>
<div id="a" class="a b c"></div>
そして JavaScript です。
js
const span = document.getElementById("ab");
const classes = span.classList;
classes.remove("c");
span.textContent = classes;
複数のクラスを一度に削除するために、複数のトークンを渡すことができます。渡す順序は、リスト中に出現する順序と一致している必要はありません。
js
const span2 = document.getElementById("a");
const classes2 = span2.classList;
classes2.remove("c", "b");
span2.textContent = classes2;
出力結果は以下のようになります。
仕様書
Specification |
---|
DOM Standard # ref-for-dom-domtokenlist-remove① |
ブラウザーの互換性
BCD tables only load in the browser