CSSStyleSheet

Интерфейс CSSStyleSheet представляет собой отдельный CSS лист стилей и позволяет просматривать и изменять список правил, содержащихся в листе стилей. Он наследует свойства и методы от своего родителя, StyleSheet.

Лист стилей состоит из набора объектов CSSRule, представляющих каждое из правил в листе стилей. Правила содержатся в CSSRuleList, который можно получить из свойства cssRules листа стилей.

Например, одно правило может быть объектом CSSStyleRule содержащим стиль, такой как:

h1,
h2 {
  font-size: 16pt;
}

Другое правило может быть правилом at-rule, таким как @import или @media, и так далее.

Различные способы получения объекта CSSStyleSheet описаны в разделе Получение листа стилей. Объект CSSStyleSheet также можно создать напрямую. Конструктор и методы CSSStyleSheet.replace() и CSSStyleSheet.replaceSync() — это новые дополнения к спецификации, позволяющие создавать стили листа.

CSSStyleSheet()

Создает новый объект CSSStyleSheet.

Наследует свойства от своего родителя, StyleSheet.

CSSStyleSheet.cssRules Только для чтения

Возвращает живой CSSRuleList, который поддерживает актуальный список объектов CSSRule, составляющих лист стилей.

Примечание: В некоторых браузерах, если лист стилей загружается с другого домена, доступ к cssRules приводит к SecurityError.

CSSStyleSheet.ownerRule Только для чтения

Если этот лист стилей импортируется в документ с помощью правила @import, свойство ownerRule возвращает соответствующее CSSImportRule; в противном случае значение этого свойства — null.

Наследует методы от своего родителя, StyleSheet.

CSSStyleSheet.deleteRule()

Удаляет правило по указанному индексу в списке правил листа стилей.

CSSStyleSheet.insertRule()

Вставляет новое правило в указанную позицию листа стилей, используя текстовое представление правила.

CSSStyleSheet.replace()

Асинхронно заменяет содержимое листа стилей и возвращает Promise, который разрешается с обновлённым объектом CSSStyleSheet.

CSSStyleSheet.replaceSync()

Синхронно заменяет содержимое листа стилей.

Эти свойства — свойства наследия, введенные Microsoft; они поддерживаются для совместимости со старыми сайтами.

rules Только для чтения Устаревшее

Свойство rules функционально идентично стандартному свойству cssRules; оно возвращает живой CSSRuleList, который поддерживает актуальный список всех правил в листе стилей.

Эти методы — методы наследия, введенные Microsoft; они поддерживаются для совместимости со старыми сайтами.

addRule() Устаревшее

Добавляет новое правило в лист стилей, используя селектор, к которому применяется стиль, и блок стиля, который применяется к соответствующим элементам.

Это отличается от insertRule(), который принимает текстовое представление всего правила как одной строки.

removeRule() Устаревшее

Функционально идентично deleteRule(); удаляет правило по указанному индексу из списка правил листа стилей.

Лист стилей связан не более чем с одним Document, к которому он применяется (если не отключён). Список объектов CSSStyleSheet для данного документа можно получить, используя свойство Document.styleSheets. Конкретный лист стилей также можно получить из его объекта-владельца (Node или CSSImportRule), если таковой имеется.

Объект CSSStyleSheet создаётся и автоматически вставляется в список Document.styleSheets документа браузером при загрузке листа стилей для документа.

Ниже представлен (возможно, неполный) список способов, которыми лист стилей может быть связан с документом:

• CSS Объектная модель
• Использование динамической информации об оформлении