CKTIS / JavaScript
Window.getComputedStyle — čtení vyřešených stylů
Window.getComputedStyle čte vyřešené hodnoty CSS prvku po použití stylů z kaskádových stylů. Vrací živý objekt pouze pro čtení, nikoli kopii vložených deklarací.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)Window.getComputedStyle, volaná jako window.getComputedStyle(element, pseudoElt), je rozhraní prohlížeče CSSOM, nikoli funkce ECMAScriptu. Metoda je široce podporovaná; samotná přítomnost Node 24 její dostupnost nepotvrzuje. element musí být objekt Element. Volitelný argument pseudoElt, například "::before", vybere pseudoelement; při vynechání nebo hodnotě null se pracuje se samotným prvkem.
Výsledek obsahuje vyřešené hodnoty: obvykle vypočtené hodnoty, u některých vlastností závislých na rozvržení však použité hodnoty. Původní zápis v kaskádovém stylu se nemusí zachovat. Čtení vlastností vrací řetězce. Element.computedStyleMap() funguje jinak: zpřístupňuje vypočtené hodnoty jako typované objekty, nikoli jako vyřešené řetězce.
Vrácený objekt CSSStyleProperties dědí z CSSStyleDeclaration; starší specifikace uváděly druhý typ. Hodnoty čtěte například pomocí styles.marginLeft nebo styles.getPropertyValue('margin-left'). Objekt je živý: další čtení odráží změnu stylu. Chcete-li zachovat snímek, uložte přečtený řetězec. Výsledek je pouze pro čtení; styly měňte prostřednictvím element.style, které představuje vložené deklarace, nikoli výsledek kaskádových stylů.
Neplatný argument element způsobí TypeError. Podle algoritmu CSSOM se metoda pokusí zpracovat řetězec předaný jako pseudoElt jako selektor pseudoelementu pouze tehdy, když začíná znakem :. Pokud se syntaktická analýza nezdaří nebo selektor označuje ::part() či ::slotted(), algoritmus vrátí objekt stylů s prázdným seznamem deklarací. Podle tohoto algoritmu se řetězec bez úvodní dvojtečky, například "before", ignoruje: metoda čte styly samotného prvku. Dokumentace metody na MDN naproti tomu uvádí, že metoda vyvolá výjimku TypeError při neplatném selektoru pseudoelementu i při použití ::part() nebo ::slotted(). Z důvodů ochrany soukromí mohou být hodnoty týkající se :visited záměrně nepřesné — tuto metodu nepoužívejte ke zjišťování historie prohlížení.
Pří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ýsledek
12px 24px
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.