DOMTokenList: contains() メソッド
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.
contains() は DOMTokenList インターフェイスのメソッドで、論理値を返します。 true は渡されたトークンがそのリストに含まれていることを表し、そうでなければ false になります。
構文
js
contains(token)
引数
token-
リストの中に存在するかどうかを調べたいトークンを表す文字列です。
返値
論理値で、 true は呼び出し元のリストにトークンが含まれていることを表し、そうでなければ false になります。
例
次の例は、 <span> 要素に設定されたクラスのリストを DOMTokenList として返すために Element.classList を使用します。 "c" がリスト中に存在することを確認し、その <span> の Node.textContent の中に結果を書き込みます。
最初に HTML です。
html
<span class="a b c"></span>
そして JavaScript です。
js
const span = document.querySelector("span");
span.textContent = span.classList.contains("c")
? "classList に 'c' が含まれています"
: "classList に 'c' が含まれていません";
出力結果は以下のようになります。
仕様書
| Specification |
|---|
| DOM # ref-for-dom-domtokenlist-contains① |