CKTIS / JavaScript
Window.getComputedStyle — čitanje razriješenih stilova
Window.getComputedStyle čita razriješene CSS vrijednosti elementa nakon primjene stilskih listova. Vraća živi objekt samo za čitanje, a ne kopiju umetnutih deklaracija.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)Window.getComputedStyle, pozvana kao window.getComputedStyle(element, pseudoElt), API je preglednika CSSOM, a ne funkcija ECMAScripta. Metoda je široko podržana; prisutnost Nodea 24 ne potvrđuje njezinu dostupnost. element mora biti objekt Element. Neobavezni argument pseudoElt, primjerice "::before", odabire pseudoelement; ako se izostavi ili je null, odnosi se na sam element.
Rezultat sadrži razriješene vrijednosti: obično izračunate vrijednosti, ali za neka svojstva ovisna o izgledu korištene vrijednosti. Izvorni zapis u stilskoj listi ne mora se sačuvati. Čitanje svojstava vraća nizove znakova. Element.computedStyleMap() razlikuje se po tome što izlaže izračunate vrijednosti kao tipizirane objekte, a ne kao razriješene nizove znakova.
Vraćeni CSSStyleProperties nasljeđuje od CSSStyleDeclaration; starije su specifikacije navodile potonji tip. Vrijednosti čitaj, primjerice, pomoću styles.marginLeft ili styles.getPropertyValue('margin-left'). Objekt je živ: novo čitanje odražava promjenu stila. Za spremanje snimke sačuvaj pročitani niz znakova. Rezultat je samo za čitanje; stilove mijenjaj putem element.style, koji predstavlja umetnute deklaracije, a ne rezultat stilskih listova.
Nevaljan argument element uzrokuje TypeError. Prema algoritmu CSSOM-a, metoda pokušava protumačiti niz znakova proslijeđen kao pseudoElt kao selektor pseudoelementa samo ako niz počinje znakom :. Ako raščlamba ne uspije ili selektor označava ::part() ili ::slotted(), algoritam vraća objekt stila s praznim popisom deklaracija. Prema tom algoritmu, niz bez početne dvotočke, primjerice "before", zanemaruje se: metoda čita stilove samog elementa. Dokumentacija metode na MDN-u, nasuprot tome, navodi da se iznimka TypeError javlja pri nevaljanim selektorima pseudoelementa te pri uporabi ::part() i ::slotted(). Zbog privatnosti vrijednosti povezane s :visited mogu biti namjerno netočne — nemoj upotrebljavati ovu metodu za otkrivanje povijesti pregledavanja.
Primjeri
(() => {
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();
}
})();Rezultat
12px 24px
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.