Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element: sostituire i nodi figli e verificare la presenza di un attributo

Usa `replaceChildren()` per sostituire o rimuovere i nodi figli di un elemento e `hasAttribute()` per verificare se l’elemento stesso ha un attributo, a prescindere dal valore.

Versione: Current web platform; runtime support varies

Sintassi

element.replaceChildren();
element.replaceChildren(firstNodeOrString, secondNodeOrString, ...moreNodesOrStrings);
element.hasAttribute(qualifiedName);

replaceChildren() e hasAttribute() sono metodi di istanza di Element nel DOM. Il primo cambia i nodi direttamente sotto un elemento; il secondo verifica un attributo dell’elemento stesso senza modificare il DOM. Sono API della piattaforma web, non funzionalità di ECMAScript 2024. Verifica che l’ambiente di esecuzione di destinazione fornisca un DOM e supporti entrambi i metodi.

element.replaceChildren(...) sostituisce tutti i nodi figli diretti, compresi quelli di testo e commento. Accetta un numero qualsiasi di nodi e stringhe. Senza argomenti, svuota l’elemento senza rimuoverlo né cambiarne gli attributi. Le stringhe diventano nodi di testo e, a differenza di un’assegnazione a innerHTML, non vengono interpretate come HTML. Il metodo restituisce undefined.

I nodi esistenti vengono spostati, non clonati. Un nodo rimosso viene scollegato dal genitore, ma puoi ancora usarlo se ne conservi un riferimento. Un inserimento che creerebbe un ciclo, ad esempio rendendo un elemento figlio di sé stesso, solleva una DOMException chiamata HierarchyRequestError.

element.hasAttribute(name) cerca un attributo per nome qualificato e restituisce true anche se il valore è vuoto o è la stringa "false". Un risultato false indica che l’attributo è assente, non che il suo valore sia falso. Per leggere il valore usa getAttribute(name), che restituisce null se l’attributo manca. Per cercare per spazio dei nomi e nome locale usa hasAttributeNS(namespace, localName). Per un attributo booleano HTML come disabled conta la presenza: assegnargli il valore "false" non lo disattiva.

Esempi

<!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>

Risultato

before: false
text: <b>literal</b> Updated
same node: true
child nodes: 0
after: true
value: ""

Salva l’esempio come file `.html`, aprilo in un browser e controlla l’output nella console. La stringa che sembra HTML rimane testo e `same node: true` conferma che `label` è ancora lo stesso nodo. Dopo essere stato svuotato, l’elemento conserva `data-ready` con valore vuoto.

Lezioni correlate

  • JavaScript · Lezione 38 · Avanzato · Versione: 4

Fonti