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 : propriété className

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 juillet 2015.

La propriété className de l'interface Element récupère et définit la valeur de l'attribut class de l'élément défini.

Valeur

Une chaîne de caractères représentant la classe ou les classes séparées par des espaces de l'élément courant.

Exemples

js
const el = document.getElementById("item");
el.className = el.className === "active" ? "inactive" : "active";

Notes

Le nom className est utilisé pour cette propriété au lieu de class à cause de conflits éventuels avec le mot-clé « class » dans beaucoup de langages utilisés pour manipuler le DOM.

className peut également être une instance de SVGAnimatedString si un element est un SVGElement. Il est plus facile d'obtenir/définir l'attribut class d'un élément en utilisant Element.getAttribute et Element.setAttribute si vous manipulez des éléments SVG. Cependant, prenez en compte que Element.getAttribute retourne null au lieu de "" si un element a un attribut class vide.

js
elm.setAttribute("class", "ma-classe");
const maClasse = elm.getAttribute("class");

Note : class est le nom d'un attribut HTML, tandis que className est le nom d'une propriété DOM.

Spécifications

Spécification
DOM
# ref-for-dom-element-classname①

Compatibilité des navigateurs

Voir aussi