CSSStyleSheet: метод addRule()

Устаревшее: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она может быть удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Избегайте использования этой функции и, при возможности, обновите существующий код; см. таблицу совместимости внизу этой страницы для принятия решения. Имейте в виду, что эта функция может перестать работать в любое время.

Устаревший интерфейс CSSStyleSheet метод addRule() legacy method добавляет новое правило в таблицу стилей. Вам следует избегать использования этого метода и вместо этого использовать более стандартный метод insertRule().

Синтаксис

addRule(selector, styleBlock, index)

Параметры

selector: Строка, определяющая селектор CSS-правила. По умолчанию — строка undefined.
styleBlock: Строка, указывающая блок стилей, который необходимо применить к элементам, соответствующим selector. По умолчанию — строка undefined.
index Необязательно: Необязательный индекс в списке правил CSSRuleList таблицы стилей, в который необходимо вставить новое правило. Если index не указан, используется следующий индекс после последнего элемента, который в настоящее время находится в списке (т.е. значение cssStyleSheet.cssRules.length).

Возвращаемое значение

Всегда возвращает -1.

Обратите внимание, что из-за несколько специфичных правил о том, где можно вставить правила, может быть выброшено исключение. Более подробная информация в insertRule().

Примечания по использованию

Этот метод реализован браузерами путём построения строки с использованием шаблона `${selector}{${styleBlock}}`, а затем передачи её в стандартный метод insertRule().

Поэтому, учитывая существующий код, такой как:

cssStyleSheet.addRule(selector, styles, 0);

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

cssStyleSheet.insertRule(`${selector} {${styles}}`, 0);

Спецификации

Спецификация
CSS Object Model (CSSOM) # dom-cssstylesheet-addrule

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`addRule`	1	12	68	15	1	18	68	14	1	1.0	4.4

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CSSStyleSheet/addRule