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 для сокращённых свойств.

Пример

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	Status	Comment
CSS Object Model (CSSOM) Определение 'CSSStyleDeclaration' в этой спецификации.	Рабочий черновик
Document Object Model (DOM) Level 2 Style Specification Определение 'CSSPrimitiveValue' в этой спецификации.	Устаревшая	Изначальное определение

Смотрите также

DOM CSS Properties (en-US)

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

BCD tables only load in the browser