Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła