Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri