CKTIS / JavaScript
Element : remplacer les nœuds enfants et vérifier la présence d’un attribut
Utilisez `replaceChildren()` pour remplacer ou retirer les nœuds enfants d’un élément, et `hasAttribute()` pour vérifier si l’élément possède un attribut, quelle que soit sa valeur.
Version : Current web platform; runtime support varies
Syntaxe
element.replaceChildren();
element.replaceChildren(firstNodeOrString, secondNodeOrString, ...moreNodesOrStrings);
element.hasAttribute(qualifiedName);replaceChildren() et hasAttribute() sont des méthodes d’instance de Element dans le DOM. La première modifie les nœuds situés directement sous un élément ; la seconde vérifie un attribut de l’élément lui-même sans modifier le DOM. Elles relèvent de la plateforme web, pas d’ECMAScript 2024. Vérifiez que l’environnement cible fournit un DOM et prend en charge les deux méthodes.
element.replaceChildren(...) remplace tous les nœuds enfants directs, y compris les nœuds de texte et de commentaire. Cette méthode accepte un nombre quelconque de nœuds et de chaînes. Sans argument, elle vide l’élément sans le supprimer ni changer ses attributs. Les chaînes deviennent des nœuds de texte : contrairement à une affectation à innerHTML, elles ne sont pas analysées comme du HTML. La méthode renvoie undefined.
Les nœuds existants sont déplacés, pas clonés. Un nœud retiré est détaché de son parent, mais reste utilisable si vous en gardez une référence. Une insertion qui créerait un cycle, par exemple en faisant d’un élément son propre enfant, lève une DOMException nommée HierarchyRequestError.
element.hasAttribute(name) recherche un attribut par son nom qualifié et renvoie true même si la valeur est vide ou vaut la chaîne "false". Un résultat false signifie que l’attribut est absent, et non que sa valeur est fausse. Pour lire la valeur, utilisez getAttribute(name), qui renvoie null si l’attribut est absent. Pour rechercher par espace de noms et nom local, utilisez hasAttributeNS(namespace, localName). Pour un attribut booléen HTML comme disabled, c’est sa présence qui compte : lui donner la valeur "false" ne le désactive pas.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Replacing child nodes and checking attribute presence</title>
</head>
<body>
<script>
(() => {
const panel = document.createElement("div");
const label = document.createElement("strong");
label.textContent = "Updated";
panel.append("Old: ", label);
console.log(`before: ${panel.hasAttribute("data-ready")}`);
panel.setAttribute("data-ready", "");
panel.replaceChildren("<b>literal</b> ", label);
console.log(`text: ${panel.textContent}`);
console.log(`same node: ${panel.lastChild === label}`);
panel.replaceChildren();
console.log(`child nodes: ${panel.childNodes.length}`);
console.log(`after: ${panel.hasAttribute("data-ready")}`);
console.log(`value: ${JSON.stringify(panel.getAttribute("data-ready"))}`);
})();
</script>
</body>
</html>Résultat
before: false text: <b>literal</b> Updated same node: true child nodes: 0 after: true value: ""
Enregistrez l’exemple dans un fichier `.html`, ouvrez-le dans un navigateur et vérifiez le résultat dans la console. La chaîne qui ressemble à du HTML reste du texte, et `same node: true` confirme que `label` est toujours le même nœud. Après avoir été vidé, l’élément possède encore l’attribut `data-ready` avec une valeur vide.
Leçons associées
- JavaScript · Leçon 38 · Avancé · Version : 4