Интерфейс CSSStyleDeclaration
представляет объект, являющийся блоком объявления CSS, и предоставляет информацию о стиле и различные связанные со стилем методы и свойства.
Объект CSSStyleDeclaration
может быть представлен с помощью трех различных API:
- Через
HTMLElement.style
, который имеет дело с встроенными стилями одного элемента (например, <div style="...">). - Через API
CSSStyleSheet
. Например,document.styleSheets[0].cssRules[0].style
возвращает объектCSSStyleDeclaration
для первого правила CSS в первой таблице стилей документа. - Через
Window.getComputedStyle ()
, который предоставляет объектCSSStyleDeclaration
в качестве интерфейса только для чтения.
Аттрибуты
CSSStyleDeclaration.cssText
- Текстовое представление блока объявления. Установка этого атрибута изменяет стиль.
CSSStyleDeclaration.length
Только для чтения- Количество свойств. Смотри ниже метод
item()
. CSSStyleDeclaration.parentRule
Только для чтения- Содержащееся
CSSRule
.
Методы
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);
Спецификации
Specification | Status | Comment |
---|---|---|
CSS Object Model (CSSOM) Определение 'CSSStyleDeclaration' в этой спецификации. |
Рабочий черновик | |
Document Object Model (DOM) Level 2 Style Specification Определение 'CSSPrimitiveValue' в этой спецификации. |
Устаревшая | Изначальное определение |
Смотри также
Совместимость браузеров
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.