HTML DOM classListPropriété
Exemples
Ajouter une classe à l'élément <div> :
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
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 :
|
| 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> :
Essayez-le vous-même »
Exemple
Supprimer une classe de l'élément <div> :
Essayez-le vous-même »
Exemple
Supprimer plusieurs classes de l'élément <div> :
Essayez-le vous-même »
Exemple
Basculer une classe sur l'élément <div> :
Essayez-le vous-même »
Exemple
Obtenez les noms de classe de l'élément <div> :
var x = document.getElementById("myDIV").classList;
xLe résultat est :
Essayez-le vous-même »
Exemple
Voyez combien de noms de classe l'élément <div> possède :
xLe résultat est :
Essayez-le vous-même »
Exemple
Obtenez le premier nom de classe (index 0) de l'élément <div> :
xLe résultat est :
Essayez-le vous-même »
Exemple
Vérifiez si l'élément possède la classe "mystyle" :
xLe résultat est :
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 :
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
Autres extensions
Objet Element