CKTIS / JavaScript
Window.getComputedStyle — branje razrešenih slogov
Window.getComputedStyle prebere razrešene vrednosti CSS elementa po uporabi slogovnih datotek. Vrne živ objekt, ki je samo za branje, ne pa kopije slogovnih deklaracij v vrstici.
Različica: 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, klicana kot window.getComputedStyle(element, pseudoElt), je API brskalnika CSSOM in ne funkcija ECMAScript. Metoda je široko podprta; prisotnost Node 24 ne potrjuje njene razpoložljivosti. element mora biti objekt Element. Izbirni argument pseudoElt, na primer "::before", izbere psevdoelement; če ga izpustiš ali je null, se uporabi sam element.
Rezultat vsebuje razrešene vrednosti: običajno izračunane vrednosti, pri nekaterih lastnostih, odvisnih od postavitve, pa uporabljene vrednosti. Izvirni zapis v slogovni datoteki se morda ne ohrani. Branje lastnosti vrne nize. Element.computedStyleMap() deluje drugače: izpostavi izračunane vrednosti kot tipizirane objekte, ne pa kot razrešene nize.
Vrnjeni CSSStyleProperties deduje od CSSStyleDeclaration; starejše specifikacije so navajale drugi tip. Vrednosti preberi na primer z styles.marginLeft ali styles.getPropertyValue('margin-left'). Objekt je živ: poznejše branje odraža spremembo sloga. Če želiš ohraniti posnetek, shrani prebrani niz. Rezultat je samo za branje; sloge spreminjaj prek element.style, ki predstavlja slogovne deklaracije v vrstici, ne pa rezultata slogovnih datotek.
Neveljaven argument element povzroči TypeError. Po algoritmu CSSOM metoda poskusi razčleniti niz v argumentu pseudoElt kot izbirnik psevdoelementa le, če se niz začne z znakom :. Če razčlenjevanje ne uspe ali če izbirnik označuje ::part() ali ::slotted(), algoritem vrne slogovni objekt s praznim seznamom deklaracij. Po tem algoritmu se niz brez začetnega dvopičja, na primer "before", prezre: metoda prebere sloge samega elementa. Dokumentacija metode na MDN pa navaja, da metoda sproži izjemo TypeError pri neveljavnih izbirnikih psevdoelementov ter pri ::part() in ::slotted(). Zaradi zasebnosti so lahko vrednosti za :visited namerno netočne — te metode ne uporabljaj za ugotavljanje zgodovine brskanja.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.