CSSStyleDeclaration

Этот перевод не завершен. Пожалуйста, помогите перевести эту статью с английского

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

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

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

Attributes

CSSStyleDeclaration.cssText
Текстовое представление блока объявления. Установка этого атрибута изменяет стиль.
CSSStyleDeclaration.length Только для чтения
Количество свойств. Смотри ниже метод item() .
CSSStyleDeclaration.parentRule Только для чтения
Содержание CSSRule.

Methods

CSSStyleDeclaration.getPropertyPriority()
Возвращает необязательный приоритет "important".
CSSStyleDeclaration.getPropertyValue()
Возвращает значение свойства, заданное именем свойства.
CSSStyleDeclaration.item()
Возвращает имя свойства.
CSSStyleDeclaration.removeProperty()
Удаляет свойство из блока объявления CSS.
CSSStyleDeclaration.setProperty()
Изменяет существующее свойство CSS или создает новое свойство CSS в блоке объявления.
CSSStyleDeclaration.getPropertyCSSValue()
Поддерживается только через getComputedStyle в Firefox. Возвращает значение свойства в виде CSSPrimitiveValue или 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);

See also

Specifications

Specification Status Comment
CSS Object Model (CSSOM)
Определение 'CSSStyleDeclaration' в этой спецификации.
Рабочий черновик
Document Object Model (DOM) Level 2 Style Specification
Определение 'CSSPrimitiveValue' в этой спецификации.
Устаревшая Initial definition