CKTIS / JavaScript
Window.getComputedStyle — aufgelöste Stile auslesen
Window.getComputedStyle liest die aufgelösten CSS-Werte eines Elements, nachdem Stylesheets angewendet wurden. Die Methode gibt ein lebendes, schreibgeschütztes Objekt zurück, keine Kopie der Inline-Deklarationen.
Version: 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, aufgerufen als window.getComputedStyle(element, pseudoElt), ist eine Browser-API des CSSOM und keine ECMAScript-Funktion. Die Methode wird breit unterstützt; das Vorhandensein von Node 24 belegt ihre Verfügbarkeit nicht. element muss ein Element-Objekt sein. Das optionale pseudoElt, etwa "::before", wählt ein Pseudoelement aus; wird es weggelassen oder auf null gesetzt, ist das Element selbst gemeint.
Das Ergebnis enthält aufgelöste Werte: meist berechnete Werte, bei einigen layoutabhängigen Eigenschaften jedoch verwendete Werte. Die ursprüngliche Schreibweise im Stylesheet muss dabei nicht erhalten bleiben. Eigenschaftswerte werden als Zeichenfolgen ausgelesen. Anders funktioniert Element.computedStyleMap(): Es stellt berechnete Werte als typisierte Objekte statt als aufgelöste Zeichenfolgen bereit.
Das zurückgegebene CSSStyleProperties erbt von CSSStyleDeclaration; ältere Spezifikationen nannten den letzteren Typ. Werte lassen sich beispielsweise mit styles.marginLeft oder styles.getPropertyValue('margin-left') auslesen. Das Objekt ist lebend: Bei einem erneuten Auslesen wird eine Stiländerung berücksichtigt. Für eine Momentaufnahme speicherst du die ausgelesene Zeichenfolge. Das Ergebnis ist schreibgeschützt; ändere Stile über element.style, das Inline-Deklarationen und nicht das Ergebnis der Stylesheets darstellt.
Ein ungültiges element-Argument führt zu TypeError. Nach dem CSSOM-Algorithmus versucht die Methode nur dann, eine als pseudoElt übergebene Zeichenfolge als Pseudoelement-Selektor zu parsen, wenn sie mit : beginnt. Schlägt das Parsen fehl oder gibt der Selektor ::part() oder ::slotted() an, sieht der Algorithmus die Rückgabe eines Stilobjekts mit leerer Deklarationsliste vor. Eine Zeichenfolge ohne führenden Doppelpunkt, etwa "before", wird nach diesem Algorithmus ignoriert: Die Methode liest die Stile des Elements selbst aus. Die MDN-Referenz zur Methode nennt dagegen TypeError für ungültige Pseudoelement-Selektoren sowie für ::part() und ::slotted(). Aus Datenschutzgründen können Werte zu :visited absichtlich ungenau sein — verwende diese Methode nicht, um den Browserverlauf zu erkennen.
Beispiele
(() => {
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();
}
})();Ergebnis
12px 24px
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.