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

CKTIS / JavaScript

Element.innerHTML et Element.className

Utilisez `innerHTML` pour lire ou remplacer le contenu d’un élément, et `className` pour lire ou définir ses classes CSS.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;

innerHTML et className sont deux propriétés d’instance distinctes du DOM, pas des méthodes. Elles relèvent de la plateforme web et non d’ECMAScript 2024 : un environnement JavaScript sans DOM ne les fournit pas.

En lecture, element.innerHTML sérialise le contenu actuel en une chaîne, sans les balises de l’élément lui-même ni les racines du DOM fantôme. En écriture, le fragment est analysé comme du HTML ou du XML selon le document, puis les nœuds enfants sont remplacés, pas l’élément lui-même. Même un balisage identique crée de nouveaux nœuds : les anciennes références désignent toujours les nœuds retirés, et leurs écouteurs d’événements ne sont pas transférés. Pour un template, l’affectation remplace les nœuds enfants du DocumentFragment renvoyé par content, et non le fragment lui-même. Affecter null revient à affecter "". Dans un document XML, un fragment mal formé déclenche SyntaxError et un échec de sérialisation peut déclencher InvalidStateError ; ce sont deux noms de DOMException.

Pour un élément HTML, element.className reflète l’attribut class sous la forme d’une chaîne de noms séparés par des caractères d’espacement. Une affectation remplace toute la valeur de l’attribut sans modifier les nœuds enfants. Pour modifier une classe sans toucher aux autres, utilisez classList.add(), classList.remove() ou classList.toggle(). Sur un élément SVG, className peut être un SVGAnimatedString ; préférez getAttribute("class") ou setAttribute("class", value) pour lire ou écrire l’attribut entier. getAttribute() renvoie null si l’attribut est absent et "" s’il est présent mais vide.

Par défaut, innerHTML n’assainit pas les données. N’y affectez jamais directement des données non fiables : cela peut permettre une injection de script (XSS). Pour du texte brut dans un élément ordinaire, utilisez textContent afin que le texte ne soit pas analysé comme du HTML. Si vous avez besoin de balisage issu d’une source non fiable, assainissez-le d’abord. Quand Trusted Types est pris en charge, une politique peut renvoyer le contenu assaini sous forme de TrustedHTML ; le type lui-même n’assainit rien. Si la CSP impose Trusted Types et qu’aucune politique par défaut n’existe, l’affectation d’une chaîne déclenche TypeError.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>innerHTML and className</title>
</head>
<body>
  <script>
    {
      const card = document.createElement("div");
      card.className = "card muted";
      card.innerHTML = "<strong>Ready</strong>";
      const original = card.firstElementChild;

      card.className = "card active";
      card.classList.add("highlight");
      console.log(card.className);
      console.log(card.firstElementChild === original);

      card.innerHTML = "<strong>Ready</strong>";
      console.log(card.firstElementChild === original);
      console.log(card.innerHTML);
    }
  </script>
</body>
</html>

Résultat

card active highlight
true
false
<strong>Ready</strong>

Enregistrez l’exemple complet dans un fichier HTML et ouvrez-le dans un navigateur, sans CSP imposant Trusted Types. Le résultat s’affiche dans la console du navigateur. L’élément reste hors du document. Modifier ses classes conserve le nœud enfant ; réaffecter un HTML identique le remplace.

Leçons associées

  • JavaScript · Leçon 42 · Intermédiaire · Version : 3

Sources