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
# ref-for-dom-domtokenlist-remove①

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
remove
Multiple parameters for remove()

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support