CKTIS / JavaScript
Element.innerHTML, tagName en namespaceURI
Lees en vervang de opmaak van een DOM-element en onderscheid elementen aan de hand van hun lokale naam en naamruimte wanneer HTML en SVG in dezelfde DOM-boom voorkomen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.innerHTML
element.innerHTML = markup
element.tagName
element.namespaceURIinnerHTML geeft de huidige inhoud van het element terug als geserialiseerde tekenreeks, zonder de tags van het element zelf en zonder shadow roots. Als je een tekenreeks of een TrustedHTML-waarde toewijst, wordt een fragment geparseerd in de context van het element. Het vervangt de onderliggende knopen, niet het element zelf. Verwijzingen naar oude knopen blijven naar die objecten wijzen, niet naar de nieuwe knopen. Bij een HTML-element template lees en schrijf je de inhoud van content. null toewijzen heeft hetzelfde effect als een lege tekenreeks toewijzen.
Een HTML-document gebruikt de HTML-parser, die fouten in de opmaak kan herstellen. Een XML-document, waaronder XHTML dat als XML wordt aangeboden, gebruikt de XML-parser. Een fragment dat niet welgevormd is, veroorzaakt een DOMException met de naam SyntaxError.
tagName is de alleen-lezen gekwalificeerde naam, met een voorvoegsel als dat er is. De ASCII-letters in de naam worden alleen hoofdletters voor elementen in de HTML-naamruimte waarvan het document HTML is. Ook namespaceURI is alleen-lezen: deze eigenschap geeft de naamruimte-URI terug die bij het aanmaken is vastgelegd, of null als er geen naamruimte is. Het element verplaatsen of een xmlns-attribuut wijzigen verandert de waarde niet. Vergelijk in een boom met meerdere naamruimten namespaceURI en localName (de naam zonder voorvoegsel). Gebruik document.createElementNS() om bij het aanmaken expliciet een naamruimte te kiezen.
Wijs geen onbetrouwbare opmaak toe aan innerHTML: die wordt standaard niet opgeschoond en kan leiden tot XSS, bijvoorbeeld via attributen die gebeurtenissen afhandelen. Gebruik voor platte tekst textContent. Als de CSP Trusted Types afdwingt, veroorzaakt het toewijzen van een gewone tekenreeks zonder standaardbeleid een TypeError. Een TrustedHTML-waarde is slechts zo veilig als het beleid dat die waarde heeft gemaakt. Deze API’s horen bij het webplatform, niet bij ECMAScript 2024; ga er niet van uit dat ze beschikbaar zijn in omgevingen zonder DOM.
Voorbeelden
<!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>Resultaat
<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
Sla het voorbeeld op als `.html`-bestand en open het rechtstreeks in een browser. Bekijk de uitvoer in de ontwikkelaarsconsole. Beide elementen hebben `a` als `localName`, maar hun `tagName` en `namespaceURI` verschillen. De laatste `true` betekent dat de oude onderliggende knoop geen ouderknoop meer heeft.
Gerelateerde lessen
- JavaScript · Les 16 · Gevorderd · Versie: 4