CKTIS / JavaScript
`className` et `innerHTML` : classes et contenu d’un élément
`className` reflète l’attribut `class`. `innerHTML` lit le balisage sérialisé du contenu ou analyse un fragment pour remplacer ce contenu.
Version : Current web platform; runtime support varies
Syntaxe
element.className;
htmlElement.className = classString;
element.innerHTML;
element.innerHTML = markup;className et innerHTML sont deux propriétés d’instance du DOM, et non des méthodes ou des fonctionnalités du langage ECMAScript. Elles sont fournies par un environnement doté d’un DOM, pas par le moteur JavaScript seul.
Sur un élément HTML, className lit l’attribut class sous forme de chaîne (vide si l’attribut est absent), et une affectation remplace toute sa valeur. Pour ajouter, retirer ou basculer une classe sans perdre les autres, utilise classList.add(), remove() ou toggle(). Sur un élément SVG, className peut être un objet SVGAnimatedString plutôt qu’une chaîne. Pour traiter les deux types d’éléments, utilise getAttribute("class") et setAttribute("class", value) pour lire et écrire le texte de l’attribut. Si l’attribut est absent, getAttribute() renvoie null.
La lecture de innerHTML sérialise le contenu en HTML ou en XML, sans les balises de l’élément lui-même ni les racines du Shadow DOM. Le résultat ne reproduit pas forcément le texte source. Une affectation analyse un fragment dans le contexte de l’élément et remplace ses nœuds enfants sans remplacer l’élément lui-même. Pour un template, c’est le contenu du modèle qui est remplacé. Les anciens nœuds sont détachés ; les références les désignent toujours et leurs écouteurs d’événements ne sont pas transférés aux nouveaux nœuds. Dans un document XML, un fragment mal formé lève une DOMException nommée SyntaxError.
innerHTML n’assainit pas le balisage. Les éléments script insérés ne s’exécutent pas, mais les attributs de gestion d’événements peuvent encore permettre une attaque XSS. Utilise textContent pour insérer du texte brut dans un élément ordinaire. Si un balisage non fiable est nécessaire, assainis-le d’abord. Lorsqu’une CSP prise en charge impose Trusted Types, affecter une chaîne sans politique par défaut lève une TypeError. Tu peux fournir à la place du TrustedHTML produit par une politique qui assainit l’entrée.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>className and innerHTML</title>
<script>
const card = document.createElement("div");
const oldChild = document.createElement("span");
card.append(oldChild);
card.className = "card draft";
card.className = "card ready";
console.log(card.className);
console.log(oldChild.parentNode === card);
card.innerHTML = "<strong>Ready</strong>";
console.log(card.innerHTML);
console.log(oldChild.parentNode === null);
</script>Résultat
card ready true <strong>Ready</strong> true
Enregistre l’exemple dans un fichier `.html`, ouvre-le dans un navigateur et consulte la console. Le premier `true` montre que le changement de classes conserve l’ancien enfant ; le second montre que l’affectation à `innerHTML` le détache.
Leçons associées
- JavaScript · Leçon 11 · Avancé · Version : 4