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

CKTIS / JavaScript

Element.innerHTML, tagName et namespaceURI

Lisez et remplacez le balisage d’un élément du DOM, puis distinguez les éléments par leur nom local et leur espace de noms lorsque HTML et SVG cohabitent dans le même arbre.

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

Syntaxe

element.innerHTML
 element.innerHTML = markup
 element.tagName
 element.namespaceURI

innerHTML renvoie le contenu actuel de l’élément sous forme de chaîne sérialisée, sans les balises de l’élément lui-même ni les racines du Shadow DOM. Affecter une chaîne ou une valeur TrustedHTML analyse un fragment dans le contexte de l’élément et remplace ses nœuds enfants, pas l’élément lui-même. Les références aux anciens nœuds désignent toujours les mêmes objets, pas leurs remplaçants. Pour un élément HTML template, la lecture et l’écriture portent sur son content. Affecter null revient à affecter une chaîne vide.

Un document HTML utilise l’analyseur HTML, qui peut corriger un balisage mal formé. Un document XML, y compris du XHTML servi en XML, utilise l’analyseur XML. Un fragment qui n’est pas bien formé déclenche une DOMException nommée SyntaxError.

tagName est le nom qualifié en lecture seule, préfixe compris s’il y en a un. Seuls les éléments de l’espace de noms HTML dans un document HTML voient les lettres ASCII de ce nom converties en majuscules. namespaceURI est également en lecture seule : cette propriété renvoie l’URI de l’espace de noms fixé à la création de l’élément, ou null en l’absence d’espace de noms. Déplacer l’élément ou modifier un attribut xmlns ne change pas cette valeur. Dans un arbre qui mélange plusieurs espaces de noms, comparez namespaceURI et localName (le nom sans préfixe). Utilisez document.createElementNS() pour choisir explicitement l’espace de noms lors de la création.

N’affectez pas de balisage non fiable à innerHTML : il n’est pas assaini par défaut et peut permettre une attaque XSS, notamment via les attributs de gestion d’événements. Pour du texte brut, utilisez textContent. Si la CSP impose Trusted Types, l’affectation d’une chaîne ordinaire sans politique par défaut déclenche un TypeError. Une valeur TrustedHTML n’est pas plus sûre que la politique qui l’a produite. Ces API relèvent de la plateforme web et non d’ECMAScript 2024 ; ne supposez pas qu’elles existent dans un environnement sans DOM.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML and SVG element names</title>
</head>
<body>
  <script>
    const container = document.createElement('div');
    const previous = document.createElement('span');
    container.appendChild(previous);

    container.innerHTML = '<a>HTML</a><svg><a>SVG</a></svg>';
    const htmlLink = container.firstElementChild;
    const svgLink = container.lastElementChild.firstElementChild;

    console.log(container.innerHTML);
    for (const link of [htmlLink, svgLink]) {
      console.log(`${link.tagName} | ${link.localName} | ${link.namespaceURI}`);
    }
    console.log(previous.parentNode === null);
  </script>
</body>
</html>

Résultat

<a>HTML</a><svg><a>SVG</a></svg>
A | a | http://www.w3.org/1999/xhtml
a | a | http://www.w3.org/2000/svg
true

Enregistrez l’exemple dans un fichier `.html` et ouvrez-le directement dans un navigateur. Consultez le résultat dans la console des outils de développement. Les deux éléments ont `a` pour `localName`, mais leurs valeurs de `tagName` et de `namespaceURI` diffèrent. Le dernier `true` indique que l’ancien nœud enfant n’a plus de parent.

Leçons associées

  • JavaScript · Leçon 16 · Avancé · Version : 4

Sources