KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Window.getComputedStyle — opgeloste stijlen uitlezen

Window.getComputedStyle leest de opgeloste CSS-waarden van een element nadat stylesheets zijn toegepast. De methode retourneert een levend, alleen-lezen object en geen kopie van inline declaraties.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)

Window.getComputedStyle, aangeroepen als window.getComputedStyle(element, pseudoElt), is een CSSOM-browser-API en geen ECMAScript-functie. De methode wordt breed ondersteund; de aanwezigheid van Node 24 bevestigt niet dat de methode beschikbaar is. element moet een Element-object zijn. Met het optionele pseudoElt, zoals "::before", selecteer je een pseudo-element; als je het weglaat of null gebruikt, geldt de methode voor het element zelf.

Het resultaat bevat opgeloste waarden: meestal berekende waarden, maar voor sommige layoutafhankelijke eigenschappen gebruikte waarden. De oorspronkelijke notatie uit de stylesheet blijft niet noodzakelijk behouden. Het uitlezen van eigenschappen retourneert tekenreeksen. Element.computedStyleMap() werkt anders: deze methode geeft berekende waarden als getypeerde objecten weer in plaats van als opgeloste tekenreeksen.

Het geretourneerde CSSStyleProperties erft van CSSStyleDeclaration; oudere specificaties noemden het laatstgenoemde type. Lees waarden bijvoorbeeld met styles.marginLeft of styles.getPropertyValue('margin-left'). Het object is levend: bij een volgende uitlezing zie je een stijlwijziging. Bewaar de gelezen tekenreeks om een momentopname vast te leggen. Het resultaat is alleen-lezen; wijzig stijlen via element.style, dat inline declaraties weergeeft en niet het resultaat van stylesheets.

Een ongeldig element-argument veroorzaakt een TypeError. Volgens het CSSOM-algoritme probeert de methode een tekenreeks die als pseudoElt is meegegeven alleen als pseudo-elementselector te ontleden als die met : begint. Als het ontleden mislukt of de selector ::part() of ::slotted() aanduidt, retourneert het algoritme een stijlobject met een lege declaratielijst. Volgens dat algoritme wordt een tekenreeks die niet met een dubbele punt begint, zoals "before", genegeerd: de methode leest de stijlen van het element zelf uit. De documentatie van de methode op MDN vermeldt daarentegen dat de methode een TypeError opwerpt bij ongeldige pseudo-elementselectors en bij ::part() en ::slotted(). Om privacyredenen kunnen waarden over :visited opzettelijk onnauwkeurig zijn — gebruik deze methode niet om de browsergeschiedenis te achterhalen.

Voorbeelden

(() => {
  const frame = document.createElement('iframe');
  document.body.append(frame);
  try {
    const doc = frame.contentDocument;
    const box = doc.createElement('div');
    box.style.cssText = 'margin-left: 12px;';
    doc.body.append(box);

    const styles = frame.contentWindow.getComputedStyle(box);
    console.log(styles.getPropertyValue('margin-left'));
    box.style.marginLeft = '24px';
    console.log(styles.marginLeft);
  } finally {
    frame.remove();
  }
})();

Resultaat

12px
24px

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen