CKTIS / JavaScript
Window.getComputedStyle — odczyt stylów rozstrzygniętych
Window.getComputedStyle odczytuje rozstrzygnięte wartości CSS elementu po uwzględnieniu arkuszy stylów. Zwraca żywy obiekt tylko do odczytu, a nie kopię deklaracji inline.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)Window.getComputedStyle, wywoływane jako window.getComputedStyle(element, pseudoElt), jest API przeglądarki z CSSOM, nie funkcją ECMAScript. Metoda jest szeroko obsługiwana; obecność Node 24 nie potwierdza jej dostępności. element musi być obiektem Element. Opcjonalne pseudoElt, np. "::before", wybiera pseudoelement; pominięcie lub null oznacza sam element.
Wynik zawiera wartości rozstrzygnięte: zwykle obliczone, lecz dla niektórych właściwości zależnych od układu — wartości użyte. Nie musi zachowywać zapisu z arkusza. Odczyty właściwości zwracają ciągi znaków. Inaczej działa Element.computedStyleMap(): udostępnia wartości obliczone jako obiekty typowane, a nie rozstrzygnięte ciągi znaków.
Zwrócony CSSStyleProperties dziedziczy po CSSStyleDeclaration; starsze specyfikacje wskazywały ten drugi typ. Odczytuj np. styles.marginLeft lub styles.getPropertyValue('margin-left'). Obiekt jest żywy: ponowny odczyt uwzględnia zmianę stylu. Aby zachować migawkę, zapisz odczytany ciąg znaków. Wynik jest tylko do odczytu; zmieniaj style przez element.style, które reprezentuje deklaracje inline, a nie wynik działania arkuszy.
Nieprawidłowy argument element powoduje TypeError. Zgodnie z algorytmem CSSOM metoda próbuje zinterpretować ciąg pseudoElt jako selektor pseudoelementu tylko wtedy, gdy zaczyna się on od :. Jeśli analiza składniowa się nie powiedzie lub selektor wskazuje ::part() albo ::slotted(), algorytm przewiduje zwrócenie obiektu stylów z pustą listą deklaracji. Ciąg bez początkowego dwukropka, np. "before", jest według tego algorytmu ignorowany: metoda odczytuje wtedy style samego elementu. Dokumentacja metody w MDN podaje natomiast, że nieprawidłowe selektory pseudoelementów oraz ::part() i ::slotted() powodują zgłoszenie TypeError. Ze względów prywatności wartości dotyczące :visited mogą być celowo zafałszowane — nie używaj tej metody do wykrywania historii odwiedzin.
Przykłady
(() => {
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();
}
})();Wynik
12px 24px
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.