HTML DOM classListPropriété

元素对象参考手册Objet Element

Exemples

Ajouter une classe à l'élément <div> :

document.getElementById("myDIV").classList.add("mystyle");

Essayez-le vous-même »

Définition et utilisation

La propriété classList renvoie le(s) nom(s) de classe d'un élément, sous la forme d'un objet DOMTokenList.

Cette propriété est utilisée pour ajouter, supprimer et basculer des classes CSS sur un élément.

La propriété classList est en lecture seule, mais vous pouvez la modifier à l'aide des méthodes add() et remove().


Prise en charge des navigateurs

Les nombres dans le tableau indiquent la première version de navigateur qui prend entièrement en charge la propriété.

Propriété
classList 8.0 10.0 3.6 5.1 11.5

Syntaxe

element.classList

Propriétés

Propriété Description
longueur Renvoie le nombre de classes dans la liste de classes.

Cette propriété est en lecture seule.

Méthodes

Méthode Description
add(class1, class2, ...) Ajoute un ou plusieurs noms de classe à un élément.

Si le nom de classe spécifié existe déjà, il ne sera pas ajouté.
contains(class) Renvoie une valeur booléenne, déterminant si le nom de classe spécifié existe.

Valeurs possibles :

  • true - L'élément contient déjà le nom de classe.
  • false - Le nom de classe n'existe pas dans l'élément.
item(index) Renvoie le nom de classe à l'index spécifié dans l'élément. L'index commence à 0.

Si l'index est hors plage, il renvoie null.null
remove(class1, class2, ...) Supprime un ou plusieurs noms de classe d'un élément.

Remarque :Supprimer un nom de classe qui n'existe pas ne provoquera pas d'erreur.
toggle(class, true|false) Bascule un nom de classe dans un élément.

Le premier paramètre est le nom de classe à retirer de l'élément, et renvoie false.
Si le nom de classe n'existe pas, il sera ajouté à l'élément, et renvoie true.

Le second paramètre est facultatif, une valeur booléenne utilisée pour forcer si l'élément doit ajouter ou supprimer la classe, indépendamment du fait que le nom de classe existe. Par exemple :

Supprimer une classe :element.classList.toggle("classToRemove", false);
Ajouter une classe :element.classList.toggle("classToAdd", true);

Remarque :Internet Explorer ou Opera 12 et versions antérieures ne prennent pas en charge le deuxième paramètre.

Détails techniques

Valeur de retour : Un DOMTokenList, contenant la liste des noms de classes de l'élément.

实例

Plus d’exemples

Exemple

Ajouter plusieurs classes à l'élément <div> :

document.getElementById("myDIV").classList.add("mystyle", "anotherClass", "thirdClass");

Essayez-le vous-même »

Exemple

Supprimer une classe de l'élément <div> :

document.getElementById("myDIV").classList.remove("mystyle");

Essayez-le vous-même »

Exemple

Supprimer plusieurs classes de l'élément <div> :

document.getElementById("myDIV").classList.remove("mystyle", "anotherClass", "thirdClass");

Essayez-le vous-même »

Exemple

Basculer une classe sur l'élément <div> :

document.getElementById("myDIV").classList.toggle("newClassName");

Essayez-le vous-même »

Exemple

Obtenez les noms de classe de l'élément <div> :

<div id="myDIV" class="mystyle anotherClass thirdClass">Je suis un élément DIV</div>

var x = document.getElementById("myDIV").classList;

xLe résultat est :

mystyle anotherClass thirdClass

Essayez-le vous-même »

Exemple

Voyez combien de noms de classe l'élément <div> possède :

var x = document.getElementById("myDIV").classList.length;

xLe résultat est :

3

Essayez-le vous-même »

Exemple

Obtenez le premier nom de classe (index 0) de l'élément <div> :

var x = document.getElementById("myDIV").classList.item(0);

xLe résultat est :

mystyle

Essayez-le vous-même »

Exemple

Vérifiez si l'élément possède la classe "mystyle" :

var x = document.getElementById("myDIV").classList.contains("mystyle");

xLe résultat est :

vrai

Essayez-le vous-même »

Exemple

Vérifiez si l'élément possède la classe "mystyle" ; si elle existe, supprimez un autre nom de classe :

var x = document.getElementById("myDIV");

if (x.classList.contains("myst")) {
    x.classList.remove("anotherClass");
} else {
    alert("Impossible de le trouver.");
}

Essayez-le vous-même »

Articles connexes

Tutoriel CSS :Sélecteurs CSS

Référence CSS :CSS .classSélecteurs

Référence du DOM HTML :Propriété className du DOM HTML

Référence du DOM HTML :Méthode getElementsByClassName() du DOM HTML

Référence HTML DOM :Objet Style HTML DOM

元素对象参考手册Objet Element

Autres extensions