Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources