Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Window.getComputedStyle — čítanie vyriešených štýlov

Window.getComputedStyle číta vyriešené hodnoty CSS prvku po použití štýlov z kaskádových štýlov. Vráti živý objekt iba na čítanie, nie kópiu vložených deklarácií.

Verzia: 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, volaná ako window.getComputedStyle(element, pseudoElt), je rozhranie prehliadača CSSOM, nie funkcia ECMAScriptu. Metóda je široko podporovaná; samotná prítomnosť Node 24 nepotvrdzuje jej dostupnosť. element musí byť objekt Element. Voliteľný argument pseudoElt, napríklad "::before", vyberie pseudoelement; ak sa vynechá alebo má hodnotu null, ide o samotný prvok.

Výsledok obsahuje vyriešené hodnoty: zvyčajne vypočítané hodnoty, pri niektorých vlastnostiach závislých od rozloženia však použité hodnoty. Pôvodný zápis v kaskádovom štýle sa nemusí zachovať. Čítanie vlastností vracia reťazce. Element.computedStyleMap() funguje inak: sprístupňuje vypočítané hodnoty ako typované objekty, nie ako vyriešené reťazce.

Vrátený objekt CSSStyleProperties dedí z CSSStyleDeclaration; staršie špecifikácie uvádzali druhý typ. Hodnoty čítajte napríklad pomocou styles.marginLeft alebo styles.getPropertyValue('margin-left'). Objekt je živý: ďalšie čítanie zohľadní zmenu štýlu. Ak chcete uchovať snímku, uložte prečítaný reťazec. Výsledok je iba na čítanie; štýly meňte cez element.style, ktoré predstavuje vložené deklarácie, nie výsledok kaskádových štýlov.

Neplatný argument element spôsobí TypeError. Podľa algoritmu CSSOM sa metóda pokúsi spracovať reťazec zadaný ako pseudoElt ako selektor pseudoelementu iba vtedy, keď sa začína znakom :. Ak syntaktická analýza zlyhá alebo selektor označuje ::part() či ::slotted(), algoritmus vráti objekt štýlov s prázdnym zoznamom deklarácií. Podľa tohto algoritmu sa reťazec bez úvodnej dvojbodky, napríklad "before", ignoruje: metóda číta štýly samotného prvku. Dokumentácia metódy na MDN naopak uvádza, že metóda vyvolá výnimku TypeError pri neplatnom selektore pseudoelementu aj pri použití ::part() alebo ::slotted(). Z dôvodov ochrany súkromia môžu byť hodnoty týkajúce sa :visited zámerne nepresné — túto metódu nepoužívajte na zisťovanie histórie prehliadania.

Príklady

(() => {
  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();
  }
})();

Výsledok

12px
24px

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje