KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element: klassen, inhoud en aanwezigheid van attributen

Gebruik `className` om de klassenreeks te lezen of te vervangen, `innerHTML` voor de inhoud als opmaak en `toggleAttribute()` om te bepalen of een attribuut aanwezig is.

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

Syntax

element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)

Dit zijn DOM-API’s, geen functies van ECMAScript 2024. De ECMAScript-versie die bij dit item staat, geeft niet aan of deze API’s beschikbaar zijn. Ze vereisen een omgeving die de betreffende DOM-API’s beschikbaar maakt; de ondersteuning hangt af van de uitvoeromgeving.

Op een HTML-element weerspiegelt className het attribuut class als een tekenreeks met door witruimte gescheiden klassennamen. Een toewijzing vervangt de hele tekenreeks. Gebruik classList om één klasse te wijzigen zonder de andere aan te passen. Op een SVG-element kan className een SVGAnimatedString zijn; gebruik getAttribute('class') of setAttribute('class', value) om rechtstreeks met het attribuut te werken.

Bij het lezen geeft innerHTML de HTML- of XML-opmaak van de inhoud terug, zonder het element zelf of zijn schaduwwortel. Bij het instellen wordt de opmaak in de context van het element verwerkt en worden bestaande inhoudsknopen vervangen in plaats van dat er nieuwe achteraan worden toegevoegd. Bij template wordt de sjablooninhoud vervangen. Eventlisteners blijven aan de oude knopen gekoppeld en gaan niet over naar nieuwe knopen. In een XML-document kan onjuist gevormde opmaak bij het schrijven SyntaxError veroorzaken; als serialisatie bij het lezen niet lukt, kan InvalidStateError optreden.

Geef onbetrouwbare opmaak niet rechtstreeks door aan innerHTML: die wordt standaard niet opgeschoond, wat een XSS-risico oplevert. Gebruik textContent om platte tekst weer te geven in elementen zoals span. Wijs geen onbetrouwbare tekst toe aan textContent van een script-element: die tekst kan als code worden uitgevoerd wanneer het element aan het document wordt toegevoegd. Als je opmaak nodig hebt, schoon onbetrouwbare invoer dan vóór het invoegen op. Als CSP Trusted Types afdwingt en er geen standaardbeleid is, veroorzaakt het toewijzen van een gewone tekenreeks een TypeError; gebruik TrustedHTML uit een passend beleid.

toggleAttribute(name) verwijdert een bestaand attribuut of voegt een ontbrekend attribuut met een lege waarde toe. Met force zorgt true voor aanwezigheid zonder een bestaande waarde te wijzigen, en zorgt false voor afwezigheid. De booleaanse uitkomst zegt of het attribuut na de aanroep aanwezig is, niet of er iets is veranderd. Bij een booleaans HTML-attribuut zoals disabled schakelt zelfs de waarde "false" het niet uit: aanwezigheid telt. Bij een HTML-element in een HTML-document worden ASCII-letters in de naam omgezet in kleine letters; een ongeldige naam veroorzaakt InvalidCharacterError.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element DOM example</title>
</head>
<body>
  <script>
    (() => {
      const button = document.createElement('button');
      button.className = 'action muted';
      button.className = 'action ready';

      button.innerHTML = '<span>Draft</span>';
      const oldLabel = button.firstElementChild;
      button.innerHTML = '<strong>Save</strong>';

      console.log(button.className);
      console.log(button.innerHTML);
      console.log(oldLabel.parentNode === null);
      console.log(button.toggleAttribute('disabled'));
      console.log(button.toggleAttribute('disabled', true));
      console.log(button.toggleAttribute('disabled', false));
    })();
  </script>
</body>
</html>

Resultaat

action ready
<strong>Save</strong>
true
true
true
false

Sla het voorbeeld op als HTML-bestand, open het in een browser die Trusted Types niet afdwingt en bekijk de uitvoer in de ontwikkelaarsconsole. De knop wordt niet aan het document toegevoegd. De eerste `true` bevestigt dat de oude labelknoop is losgekoppeld; de laatste drie uitkomsten tonen de toestand van `disabled` na toevoegen, aanwezig houden en verwijderen.

Gerelateerde lessen

  • JavaScript · Les 39 · Gemiddeld · Versie: 3

Bronnen