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) Этот API вышел из употребления и его работа больше не гарантируется.
Поддерживается только через 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' в этой спецификации.
Устаревшая Изначальное определение

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

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

BCD tables only load in the browser