[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/Element/classList [Back]  [Original]

Element : proprit classList - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

Element : proprit classList

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.

La proprit en lecture seule classList de l'interface Element contient une collection dynamique (DOMTokenList) reprsentant l'attribut class de l'lment. Cela peut ensuite tre utilis pour manipuler la liste des classes.

L'utilisation de classList est une alternative pratique l'accs la liste des classes d'un lment sous forme de chane de caractres dlimite par des espaces avec element.className.

Dans cet article

Valeur

Un objet DOMTokenList reprsentant le contenu de l'attribut class de l'lment. Si l'attribut class n'est pas dfini ou est vide, il retourne un DOMTokenList vide, c'est--dire un DOMTokenList avec la proprit length gale 0.

Bien que la proprit classList elle-mme soit en lecture seule dans le sens o vous ne pouvez pas remplacer l'objet DOMTokenList, vous pouvez toujours affecter directement la proprit classList, ce qui quivaut affecter sa proprit value. Vous pouvez galement modifier l'objet DOMTokenList en utilisant les mthodes add(), remove(), replace() et toggle().

Exemples

js
const div = document.createElement("div");
div.className = "toto";

// notre point de dpart : <div class="toto"></div>
console.log(div.outerHTML);

// utiliser l'API classList pour supprimer et ajouter des classes
div.classList.remove("toto");
div.classList.add("autreClasse");

// <div class="autreClasse"></div>
console.log(div.outerHTML);

// si "visible" est dfini, le supprimer, sinon, l'ajouter
div.classList.toggle("visible");

// ajouter/supprimer "visible", en fonction d'un test conditionnel, pour i infrieur  10
div.classList.toggle("visible", i < 10);

// false
console.log(div.classList.contains("toto"));

// ajouter ou supprimer plusieurs classes
div.classList.add("toto", "tata", "truc");
div.classList.remove("toto", "tata", "truc");

// ajouter ou supprimer plusieurs classes en utilisant la syntaxe de propagation
const cls = ["toto", "tata"];
div.classList.add(...cls);
div.classList.remove(...cls);

// remplacer la classe "toto" par la classe "tata"
div.classList.replace("toto", "tata");

Spcifications

Spcification
DOM
# ref-for-dom-element-classlist

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page