CKTIS / JavaScript
Element.innerHTML, tagName e namespaceURI
Leggi e sostituisci il markup di un elemento del DOM e distingui gli elementi in base al nome locale e allo spazio dei nomi quando HTML e SVG convivono nello stesso albero.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
element.innerHTML
element.innerHTML = markup
element.tagName
element.namespaceURIinnerHTML restituisce il contenuto attuale dell’elemento come stringa serializzata, senza i tag dell’elemento stesso né le radici dello Shadow DOM. Assegnare una stringa o un valore TrustedHTML fa analizzare un frammento nel contesto dell’elemento e ne sostituisce i nodi figli, non l’elemento stesso. I riferimenti ai vecchi nodi continuano a puntare a quegli oggetti, non ai nuovi nodi. Per un elemento HTML template, lettura e scrittura operano sulla sua proprietà content. Assegnare null equivale ad assegnare una stringa vuota.
Un documento HTML usa il parser HTML, che può recuperare da errori nel markup. Un documento XML, incluso XHTML servito come XML, usa il parser XML. Un frammento non ben formato genera una DOMException con nome SyntaxError.
tagName è il nome qualificato di sola lettura, comprensivo dell’eventuale prefisso. Le lettere ASCII del nome vengono convertite in maiuscolo solo per gli elementi dello spazio dei nomi HTML in un documento HTML. Anche namespaceURI è di sola lettura: restituisce l’URI dello spazio dei nomi fissato alla creazione dell’elemento, oppure null se non c’è uno spazio dei nomi. Spostare l’elemento o modificare un attributo xmlns non cambia questo valore. In un albero con più spazi dei nomi, confronta namespaceURI e localName (il nome senza prefisso). Usa document.createElementNS() per scegliere esplicitamente lo spazio dei nomi durante la creazione.
Non assegnare markup non attendibile a innerHTML: per impostazione predefinita non lo sanifica e può consentire attacchi XSS, per esempio tramite attributi che definiscono gestori di eventi. Per il testo semplice usa textContent. Se la CSP impone Trusted Types, assegnare una normale stringa senza una policy predefinita genera un TypeError. Un valore TrustedHTML è sicuro solo quanto la policy che lo ha prodotto. Queste API fanno parte della piattaforma web, non di ECMAScript 2024; non presupporre che esistano in ambienti senza DOM.
Esempi
<!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>Risultato
<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
Salva l’esempio come file `.html` e aprilo direttamente in un browser. Leggi il risultato nella console degli strumenti per sviluppatori. Entrambi gli elementi hanno `a` come `localName`, ma i valori di `tagName` e `namespaceURI` sono diversi. L’ultimo `true` indica che il vecchio nodo figlio non ha più un genitore.
Lezioni correlate
- JavaScript · Lezione 16 · Avanzato · Versione: 4