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

CKTIS / JavaScript

Element.replaceChildren() et Element.className

Remplacez ou supprimez tous les nœuds enfants d’un élément et lisez ou définissez la valeur entière de son attribut `class` indépendamment de ces nœuds.

Version : Current web platform; runtime support varies

Syntaxe

element.replaceChildren();
element.replaceChildren(node, "text");
element.replaceChildren(...items); // Spread an iterable of nodes and/or strings.
const classes = element.className; // Read the class attribute of an HTML element.
element.className = "panel ready"; // Replace the entire class attribute value.

element.replaceChildren(...items) remplace tous les nœuds enfants directs, y compris les nœuds texte, et renvoie undefined. Un même appel accepte un nombre quelconque d’objets Node et de chaînes. Les chaînes deviennent des nœuds texte et ne sont pas interprétées comme du HTML. Sans argument, l’appel vide l’élément sans le supprimer ni modifier ses attributs.

Les nœuds existants sont déplacés, pas clonés. Un nœud détaché peut être réutilisé si vous en conservez une référence. Enfreindre une règle de l’arbre DOM, par exemple en essayant d’insérer un ancêtre comme enfant de l’élément, déclenche une DOMException nommée HierarchyRequestError.

Pour un élément HTML, la propriété element.className reflète l’attribut class sous forme d’une chaîne où les noms de classe sont séparés par des caractères d’espacement. Une affectation remplace la valeur entière sans modifier les nœuds enfants. Pour modifier des classes individuellement sans toucher aux autres, utilisez classList.add(), classList.remove() ou classList.toggle(). Pour les éléments SVG, className peut être un objet SVGAnimatedString ; utilisez getAttribute('class') ou setAttribute('class', value) pour lire ou écrire l’attribut lui-même.

Dans l’indication de version, ECMAScript 2024 désigne uniquement la version de référence du langage JavaScript. Ces API DOM appartiennent à la plateforme web, pas à ECMAScript 2024. Leur disponibilité dépend de l’environnement d’exécution ; un environnement dépourvu de DOM ne les fournit pas de lui-même.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element.replaceChildren() and Element.className</title>
</head>
<body>
<script>
{
  const panel = document.createElement("div");
  panel.className = "panel loading";
  panel.textContent = "Loading…";

  const label = document.createElement("span");
  label.textContent = "Ready";
  panel.replaceChildren(label, " <pending>");
  panel.className = "panel ready";
  console.log(`${panel.childNodes.length} | ${panel.textContent} | ${panel.className}`);

  panel.replaceChildren();
  console.log(`${panel.childNodes.length} | ${panel.className}`);
}
</script>
</body>
</html>

Résultat

2 | Ready <pending> | panel ready
0 | panel ready

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console du navigateur. La première ligne montre deux nœuds enfants : l’élément `span` et le texte littéral ` <pending>`. La seconde montre qu’après la suppression des enfants, l’attribut `class` vaut toujours `panel ready`.

Leçons associées

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

Sources