CKTIS / JavaScript
Een afstammeling selecteren met querySelector() en de inhoud wijzigen met innerHTML
Vind het eerste element dat binnen een DOM-deelboom aan een CSS-selector voldoet, vang een ontbrekende treffer af en lees of vervang de interne markup.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const target = root.querySelector(selectors);
if (target !== null) {
const previousMarkup = target.innerHTML;
target.innerHTML = markup;
}Element.querySelector/innerHTML combineert twee handelingen: een element vinden en met zijn inhoud werken. root.querySelector(selectors) accepteert een tekenreeks met één CSS-selector of een door komma’s gescheiden lijst van selectors. De methode geeft het eerste passende afstammende element in DOM-boomvolgorde terug, ongeacht de volgorde van selectors in de lijst. Ze geeft nooit root zelf terug. Zonder treffer krijg je null; ongeldige selectorsyntaxis veroorzaakt een DOMException met de naam SyntaxError. Controleer de uitkomst voordat je een eigenschap leest of instelt.
Het resultaat moet onder root liggen, maar bij het toetsen van de selector kunnen ook voorouders buiten die deelboom meetellen. Gebruik :scope > .message om alleen directe kinderen van root met de klasse message te vinden. Dit is geen zoekopdracht in het hele document zoals document.querySelector().
Bij het lezen geeft target.innerHTML de geserialiseerde inhoud als tekenreeks terug, zonder de tags van het element zelf en zonder shadow roots. Bij toewijzing wordt een fragment in de context van het element geparseerd en worden zijn kinderen vervangen, niet het element zelf. Bij een template-element wordt in plaats daarvan de sjablooninhoud vervangen. Bewaarde verwijzingen en eventlisteners blijven gekoppeld aan de oude, losgekoppelde knopen, niet aan de nieuwe. In een XML-document veroorzaakt niet-welgevormde markup bij toewijzing SyntaxError. Als XML-serialisatie bij het lezen mislukt, kan InvalidStateError optreden. Beide zijn DOMExceptions.
Wijs onbetrouwbare invoer niet rechtstreeks toe aan innerHTML: de eigenschap schoont markup standaard niet op en kan tot XSS leiden. Gebruik textContent voor platte tekst. Heb je markup uit een onbetrouwbare bron nodig, schoon die dan eerst op. Trusted Types schonen zelf niets op. Als de omgeving Trusted Types ondersteunt en een CSP ze afdwingt, veroorzaakt toewijzing van een gewone tekenreeks zonder passend standaardbeleid een TypeError. Geef in plaats daarvan TrustedHTML door dat is aangemaakt door een beleid dat de invoer opschoont.
Dit zijn API’s van het webplatform, geen onderdeel van ECMAScript 2024. Controleer of de uitvoeringsomgeving een DOM biedt en de benodigde beveiligingsfuncties ondersteunt.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>querySelector() and innerHTML</title>
</head>
<body>
<script>
{
const panel = document.createElement("div");
panel.innerHTML = '<p class="message"><em>Before</em></p><p class="message">Unchanged</p>';
const target = panel.querySelector(".message");
if (target !== null) {
const oldChild = target.firstElementChild;
console.log(target.innerHTML);
target.innerHTML = "<strong>After</strong>";
console.log(target.innerHTML);
console.log(oldChild.parentNode === null);
console.log(target.nextElementSibling.textContent);
}
console.log(panel.querySelector(".missing") === null);
}
</script>
</body>
</html>Resultaat
<em>Before</em> <strong>After</strong> true Unchanged true
Sla het voorbeeld op als `.html`-bestand en open het in een browser zonder CSP die Trusted Types afdwingt. Bekijk de uitvoer in de browserconsole. Alleen de eerste treffer verandert. Het oude kind heeft geen ouder meer, het tweede element behoudt de tekst `Unchanged` en de zoekopdracht zonder treffer geeft `null` terug.
Gerelateerde lessen
- JavaScript · Les 18 · Gevorderd · Versie: 4