KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.innerHTML en Element.className

Gebruik `innerHTML` om de inhoud van een element te lezen of te vervangen, en `className` om de CSS-klassen te lezen of in te stellen.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;

innerHTML en className zijn twee afzonderlijke eigenschappen van DOM-instanties, geen methoden. Ze horen bij het webplatform en niet bij ECMAScript 2024: een JavaScript-runtime zonder DOM biedt ze niet aan.

Bij het uitlezen zet element.innerHTML de huidige inhoud om in een tekenreeks, zonder de tags van het element zelf en zonder shadow roots. Bij het toewijzen wordt een HTML- of XML-fragment geparseerd, afhankelijk van het document. De nieuwe knopen vervangen de kindknopen, niet het element zelf. Zelfs identieke opmaak levert nieuwe knopen op: oude verwijzingen blijven naar de verwijderde knopen wijzen en hun eventlisteners worden niet overgezet. Bij een template vervangt de toewijzing de kindknopen van het DocumentFragment waarnaar content verwijst, niet het fragment zelf. null toewijzen werkt hetzelfde als "" toewijzen. In een XML-document veroorzaakt een niet-welgevormd fragment een SyntaxError; een fout bij serialisatie kan een InvalidStateError veroorzaken. Beide zijn namen van DOMException.

Bij HTML-elementen geeft element.className het attribuut class weer als één tekenreeks met namen die door witruimte zijn gescheiden. Een toewijzing vervangt de hele attribuutwaarde zonder de kindknopen te wijzigen. Gebruik classList.add(), classList.remove() of classList.toggle() om één klasse aan te passen en de overige te behouden. Bij SVG-elementen kan className een SVGAnimatedString zijn. Gebruik daar getAttribute("class") of setAttribute("class", value) om het hele attribuut te lezen of te schrijven. getAttribute() geeft null terug als het attribuut ontbreekt en "" als het aanwezig maar leeg is.

innerHTML zuivert invoer standaard niet. Wijs onbetrouwbare invoer daarom nooit rechtstreeks toe: dat kan leiden tot cross-site scripting (XSS). Gebruik textContent voor platte tekst in een gewoon element, zodat die niet als HTML wordt geparseerd. Als je opmaak uit een onbetrouwbare bron nodig hebt, zuiver die dan eerst. Waar Trusted Types wordt ondersteund, kan een beleid gezuiverde inhoud als TrustedHTML teruggeven; het type zelf zuivert niets. Als de CSP Trusted Types afdwingt en er geen standaardbeleid is, veroorzaakt het toewijzen van een tekenreeks een TypeError.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>innerHTML and className</title>
</head>
<body>
  <script>
    {
      const card = document.createElement("div");
      card.className = "card muted";
      card.innerHTML = "<strong>Ready</strong>";
      const original = card.firstElementChild;

      card.className = "card active";
      card.classList.add("highlight");
      console.log(card.className);
      console.log(card.firstElementChild === original);

      card.innerHTML = "<strong>Ready</strong>";
      console.log(card.firstElementChild === original);
      console.log(card.innerHTML);
    }
  </script>
</body>
</html>

Resultaat

card active highlight
true
false
<strong>Ready</strong>

Sla het volledige voorbeeld op als HTML-bestand en open het in een browser zonder CSP die Trusted Types afdwingt. De uitvoer verschijnt in de browserconsole. Het element blijft buiten het document. Het wijzigen van de klassen behoudt de kindknoop; het toewijzen van identieke HTML vervangt die.

Gerelateerde lessen

  • JavaScript · Les 42 · Gemiddeld · Versie: 3

Bronnen