CKTIS / JavaScript
Window.getComputedStyle — прочитане на разрешените стилове
Window.getComputedStyle прочита разрешените CSS стойности на елемент след прилагането на стиловите листове. Връща жив обект само за четене, а не копие на вградените декларации.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
window.getComputedStyle(element)
window.getComputedStyle(element, pseudoElt)Window.getComputedStyle, извикана като window.getComputedStyle(element, pseudoElt), е API на браузъра от CSSOM, а не функция на ECMAScript. Методът се поддържа широко; наличието на Node 24 не потвърждава, че е достъпен. element трябва да е обект Element. Незадължителният аргумент pseudoElt, например "::before", избира псевдоелемент; ако бъде пропуснат или е null, се избира самият елемент.
Резултатът съдържа разрешени стойности: обикновено изчислени стойности, но за някои свойства, зависещи от оформлението, — използвани стойности. Първоначалният запис в стиловия лист не е задължително да се запази. Прочитането на свойства връща низове. Element.computedStyleMap() работи различно: предоставя изчислените стойности като типизирани обекти, а не като разрешени низове.
Върнатият CSSStyleProperties наследява от CSSStyleDeclaration; по-старите спецификации посочваха последния тип. Чети стойности например с styles.marginLeft или styles.getPropertyValue('margin-left'). Обектът е жив: следващо прочитане отразява промяна в стила. За да запазиш моментна снимка, запиши прочетения низ. Резултатът е само за четене; променяй стиловете чрез element.style, който представя вградените декларации, а не резултата от стиловите листове.
Невалиден аргумент element предизвиква TypeError. Според алгоритъма на CSSOM методът се опитва да разчете низа, подаден като pseudoElt, като селектор за псевдоелемент само ако низът започва с :. Ако синтактичният анализ е неуспешен или селекторът указва ::part() или ::slotted(), алгоритъмът връща обект със стилове с празен списък от декларации. Според този алгоритъм низ без начално двоеточие, например "before", се пренебрегва: методът прочита стиловете на самия елемент. В документацията на метода в MDN обаче е посочено, че при невалидни селектори за псевдоелементи, както и при ::part() и ::slotted(), се хвърля TypeError. От съображения за поверителност стойностите относно :visited може умишлено да са неточни — не използвай този метод за откриване на историята на сърфирането.
Примери
(() => {
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();
}
})();Резултат
12px 24px
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.