CKTIS / JavaScript
Window.getComputedStyle — leggere gli stili risolti
Window.getComputedStyle legge i valori CSS risolti di un elemento dopo l’applicazione dei fogli di stile. Restituisce un oggetto vivo e di sola lettura, non una copia delle dichiarazioni inline.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)Window.getComputedStyle, chiamato come window.getComputedStyle(element, pseudoElt), è un’API del browser CSSOM, non una funzione ECMAScript. Il metodo è ampiamente supportato; la presenza di Node 24 non ne conferma la disponibilità. element deve essere un oggetto Element. L’argomento facoltativo pseudoElt, ad esempio "::before", seleziona uno pseudoelemento; se omesso o impostato su null, si riferisce all’elemento stesso.
Il risultato contiene valori risolti: di solito valori calcolati, ma valori usati per alcune proprietà che dipendono dal layout. Non è detto che conservi la notazione originale del foglio di stile. La lettura delle proprietà restituisce stringhe. Element.computedStyleMap() è diverso: espone i valori calcolati come oggetti tipizzati, anziché come stringhe risolte.
CSSStyleProperties, l’oggetto restituito, eredita da CSSStyleDeclaration; le specifiche precedenti indicavano quest’ultimo tipo. Leggi i valori, per esempio, con styles.marginLeft o styles.getPropertyValue('margin-left'). L’oggetto è vivo: una lettura successiva riflette una modifica dello stile. Per conservare un’istantanea, salva la stringa letta. Il risultato è di sola lettura; modifica gli stili tramite element.style, che rappresenta le dichiarazioni inline e non il risultato dei fogli di stile.
Un argomento element non valido causa un TypeError. Secondo l’algoritmo CSSOM, il metodo tenta di interpretare la stringa passata in pseudoElt come selettore di pseudoelemento solo se inizia con :. Se l’analisi sintattica fallisce o il selettore indica ::part() o ::slotted(), l’algoritmo restituisce un oggetto di stile con una lista di dichiarazioni vuota. Secondo lo stesso algoritmo, una stringa che non inizia con i due punti, come "before", viene ignorata: il metodo legge gli stili dell’elemento stesso. La documentazione del metodo su MDN indica invece che viene sollevato un TypeError per i selettori di pseudoelemento non validi e per ::part() e ::slotted(). Per motivi di privacy, i valori relativi a :visited possono essere deliberatamente imprecisi: non usare questo metodo per rilevare la cronologia di navigazione.
Esempi
(() => {
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();
}
})();Risultato
12px 24px
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.