База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници