DOMTokenList.contains()

La méthode contains() de l'interface DOMTokenList renvoie un Boolean (booléen) — true (vrai) si la liste sous-jacente contient le symbole donné, sinon false (faux).

Syntaxe

tokenList.contains(token);

Paramètres

token
Une DOMString (chaîne de caractères) représentant la "token" (marque) dont vous voulez vérifier l'existence dans la liste.

Valeur renvoyée

Un Boolean (booléen)— true (vrai) si la liste sous-jacente contient la marque donnée, sinon false (faux).

Exemples

Dans l'exemple suivant, nous récupérons la liste des classes définies sur un élément <span> en tant que DOMTokenList en utilisant Element.classList. Nous testons ensuite l'existence de "c" dans la liste, et écrivons le résultat dans le Node.textContent du <span>.

Tout d'abord, le code HTML :

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

Maintenant, le JavaScript :

var span = document.querySelector("span");
var classes = span.classList;
var result = classes.contains("c");
if(result) {
  span.textContent = "The classList contains 'c'";
} else {
   span.textContent = "The classList does not contain 'c'";
}

La sortie ressemble à ceci :

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'contains()' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Oui) (Oui) 10 (Oui) (Oui)
Fonctionnalité Android Webview Chrome for Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Oui) (Oui) (Oui) (Oui) ? (Oui)

 

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : loella16
 Dernière mise à jour par : loella16,