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.