CSSStyleDeclaration

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

Интерфейс 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' в этой спецификации.
Устаревшая Изначальное определение

Смотри также

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
CSSStyleDeclarationChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка ДаOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
cssFloatChrome Полная поддержка 46Edge Полная поддержка 12Firefox Нет поддержки НетIE ? Opera Полная поддержка ДаSafari Полная поддержка 11WebView Android Полная поддержка 46Chrome Android Полная поддержка 46Firefox Android Нет поддержки НетOpera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 5.0
cssTextChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE ? Opera Полная поддержка ДаSafari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
getPropertyCSSValue
Устаревшая
Chrome Нет поддержки ? — 41
Замечания
Нет поддержки ? — 41
Замечания
Замечания See bug 331608.
Edge Нет поддержки Нет
Замечания
Нет поддержки Нет
Замечания
Замечания See bug 331608.
Firefox Нет поддержки 1 — 62
Замечания
Нет поддержки 1 — 62
Замечания
Замечания Only returns a result if called on the result of getComputedStyle().
IE Нет поддержки НетOpera Нет поддержки 15 — 28
Замечания
Нет поддержки 15 — 28
Замечания
Замечания See bug 331608.
Safari Полная поддержка 6WebView Android Нет поддержки ? — 41
Замечания
Нет поддержки ? — 41
Замечания
Замечания See bug 331608.
Chrome Android Нет поддержки ? — 41
Замечания
Нет поддержки ? — 41
Замечания
Замечания See bug 331608.
Firefox Android Нет поддержки 4 — 62Opera Android Нет поддержки 14 — 28
Замечания
Нет поддержки 14 — 28
Замечания
Замечания See bug 331608.
Safari iOS Полная поддержка ДаSamsung Internet Android Нет поддержки ? — 4.0
Замечания
Нет поддержки ? — 4.0
Замечания
Замечания See bug 331608.
getPropertyPriorityChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка ДаOpera Полная поддержка ДаSafari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
getPropertyValueChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка ДаOpera Полная поддержка ДаSafari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
itemChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка ДаOpera Полная поддержка ДаSafari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
lengthChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка ДаOpera Полная поддержка ДаSafari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
parentRuleChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка ДаOpera Полная поддержка ДаSafari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
removePropertyChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка ДаOpera Полная поддержка ДаSafari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 1.0
setPropertyChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка 9Opera Полная поддержка 9Safari Полная поддержка 6WebView Android Полная поддержка 4.4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка 10.1Safari iOS Полная поддержка 6Samsung Internet Android Полная поддержка 1.0

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки
Совместимость неизвестна  
Совместимость неизвестна
Устаревшая. Не следует использовать в новых веб-сайтах
Устаревшая. Не следует использовать в новых веб-сайтах
Смотрите замечания реализации.
Смотрите замечания реализации.