CSSStyleDeclaration

Интерфейс CSSStyleDeclaration представляет объект, являющийся блоком объявления CSS, и предоставляет информацию о стиле и различные связанные со стилем методы и свойства.

Объект CSSStyleDeclaration может быть представлен с помощью трёх различных API:

  • Через HTMLElement.style (en-US), который имеет дело с встроенными стилями одного элемента (например, <div style="...">).
  • Через API CSSStyleSheet. Например, document.styleSheets[0].cssRules[0].style возвращает объект CSSStyleDeclaration для первого правила CSS в первой таблице стилей документа.
  • Через Window.getComputedStyle (), который предоставляет объект CSSStyleDeclaration в качестве интерфейса только для чтения.

Атрибуты

CSSStyleDeclaration.cssText (en-US)

Текстовое представление блока объявления. Установка этого атрибута изменяет стиль.

CSSStyleDeclaration.length (en-US) Только для чтения

Количество свойств. Смотри ниже метод item() (en-US) .

CSSStyleDeclaration.parentRule (en-US) Только для чтения

Содержащееся CSSRule.

Методы

CSSStyleDeclaration.getPropertyPriority() (en-US)

Возвращает необязательный приоритет "important".

CSSStyleDeclaration.getPropertyValue()

Возвращает значение свойства, заданное именем свойства.

CSSStyleDeclaration.item() (en-US)

Возвращает имя свойства.

CSSStyleDeclaration.removeProperty() (en-US)

Удаляет свойство из блока объявления CSS.

CSSStyleDeclaration.setProperty() (en-US)

Изменяет существующее свойство CSS или создаёт новое свойство CSS в блоке объявления.

CSSStyleDeclaration.getPropertyCSSValue() (en-US)

Поддерживается только через getComputedStyle в Firefox. Возвращает значение свойства в виде CSSPrimitiveValue (en-US) или null для сокращённых свойств.

Пример

js
var styleObj = document.styleSheets[0].cssRules[0].style;
console.log(styleObj.cssText);

for (var i = styleObj.length; i--; ) {
  var nameString = styleObj[i];
  styleObj.removeProperty(nameString);
}

console.log(styleObj.cssText);

Спецификации

Specification
CSS Object Model (CSSOM)
# the-cssstyledeclaration-interface

Совместимость с браузерами

BCD tables only load in the browser