CKTIS / JavaScript
Element.className — lire et remplacer les classes
Sur un élément HTML, `className` permet de lire ou de remplacer la valeur de l’attribut `class`. Cette valeur est une chaîne de caractères, et non un tableau de classes. `SVGElement.className` est en lecture seule et renvoie un objet `SVGAnimatedString`.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
// For an HTML element:
element.className
element.className = "class1 class2";Element.className reflète l’attribut class. Pour un élément HTML, sa lecture renvoie la valeur de l’attribut sous forme de chaîne de caractères ; si l’attribut est absent, elle renvoie "".
Sur un élément HTML, l’affectation element.className = "card selected" définit la valeur complète de l’attribut. Une affectation ultérieure remplace les classes précédentes au lieu d’en ajouter une. Séparez les noms de classes par des caractères d’espacement ASCII, et non par des virgules. Une espace insécable (U+00A0) fait partie d’un seul nom de classe au lieu de séparer deux noms.
SVGElement.className est en lecture seule et renvoie un objet SVGAnimatedString, et non une chaîne de caractères.
Utilisez className pour remplacer l’ensemble des classes d’un élément HTML. Pour agir sur des classes individuelles, utilisez element.classList, qui expose un DOMTokenList. Il s’agit d’une API du DOM, et non d’une fonctionnalité du langage ECMAScript.
Exemples
const element = document.createElement("div");
console.log(JSON.stringify(element.className));
element.className = "card selected";
console.log(element.getAttribute("class"));
element.className = "compact";
console.log(element.className);Résultat
"" card selected compact
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.