CKTIS / JavaScript
HTMLElement.innerHTML: de inhoud van een element lezen en vervangen
Bij het lezen geeft `innerHTML` de inhoud van een element als markup terug. Een toewijzing vervangt die inhoud door opnieuw geparseerde knopen, ook met `+=`.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""HTMLElement.innerHTML is een instantie-eigenschap die van Element wordt geërfd, geen statische methode. Bij het lezen krijg je de huidige DOM-inhoud als tekenreeks, zonder de tags van het element zelf en zonder shadow roots. Het is een serialisatie van de boom, geen kopie van de oorspronkelijke brontekst.
Een toewijzing parseert de markup in de context van het element en vervangt de onderliggende knopen, niet het element zelf. Bij template vervangt de setter de inhoud van template.content. De setter accepteert een tekenreeks of TrustedHTML. Web IDL zet null vóór de Trusted Types-controle om in de lege tekenreeks (""). Als die tekenreeks ongewijzigd bij de parser aankomt, wordt de inhoud gewist. Als Trusted Types worden afgedwongen, kan het standaardbeleid de lege tekenreeks echter omzetten in niet-lege markup. Een geslaagde toewijzing wist de inhoud dus niet altijd. De setter maakt geen declaratieve shadow roots aan.
element.innerHTML += markup leest de geserialiseerde markup, voegt de nieuwe tekst toe en parseert het volledige resultaat opnieuw. De oude knopen worden losgekoppeld. Eventlisteners die rechtstreeks op die knopen zijn geregistreerd, gaan niet mee naar de nieuwe knopen. Wil je bestaande knopen behouden, voeg dan nieuwe toe met append().
Geef onbetrouwbare invoer niet rechtstreeks door aan innerHTML: standaard wordt de invoer niet opgeschoond. Attributen voor eventhandlers kunnen tot XSS leiden, ook al worden ingevoegde script-elementen niet uitgevoerd. Gebruik textContent voor platte tekst en een beproefde sanitizer als je HTML nodig hebt. Een Trusted Types-beleid biedt op zichzelf geen garantie dat de invoer wordt opgeschoond.
Deze API behoort tot het webplatform, niet tot ECMAScript 2024. Ondersteuning voor Trusted Types verschilt per omgeving. Als CSP Trusted Types afdwingt en er geen standaardbeleid is, veroorzaakt het toewijzen van een tekenreeks een TypeError. De HTML-parser herstelt van syntaxisfouten. In een XML-document kan een niet-welgevormd fragment bij toewijzing SyntaxError opleveren en kan onserialiseerbare inhoud bij het lezen InvalidStateError opleveren als die niet als welgevormde XML kan worden weergegeven.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML example</title>
</head>
<body>
<script>
const box = document.createElement("div");
box.innerHTML = "<strong>Hello</strong>";
const original = box.firstElementChild;
box.innerHTML += "<em> again</em>";
console.log(box.innerHTML);
console.log(box.textContent);
console.log(original === box.firstElementChild);
console.log(original.parentNode === null);
</script>
</body>
</html>Resultaat
<strong>Hello</strong><em> again</em> Hello again false true
Sla het voorbeeld op als HTML-bestand, open het in een browser zonder Trusted Types af te dwingen en bekijk de ontwikkelaarsconsole. De eerste twee regels vergelijken markup met tekst; de laatste twee laten zien dat de eerste knoop is vervangen en geen ouderknoop meer heeft.
Gerelateerde lessen
- JavaScript · Les 31 · Gevorderd · Versie: 4