CSSGroupingRule: insertRule() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

Die insertRule() Methode der CSSGroupingRule-Schnittstelle fügt eine neue CSS-Regel zu einer Liste von CSS-Regeln hinzu.

Syntax

js
insertRule(rule)
insertRule(rule, index)

Parameter

rule

Ein String

index Optional

Ein optionaler Index, an dem die Regel eingefügt werden soll; standardmäßig 0.

Rückgabewert

Der Index der neuen Regel.

Ausnahmen

IndexSizeError DOMException

Wird ausgelöst, wenn index größer als die Anzahl der untergeordneten CSS-Regeln ist.

HierarchyRequestError DOMException

Wird ausgelöst, wenn aufgrund von durch CSS festgelegten Einschränkungen die neue Regel nicht an der angegebenen (Null-basierten) Indexposition in die Liste eingefügt werden kann.

InvalidStateError DOMException

Wird ausgelöst, wenn die neue Regel eine @namespace At-Regel ist und die Liste der untergeordneten CSS-Regeln etwas anderes als @import At-Regeln und @namespace At-Regeln enthält.

Beispiele

js
let myRules = document.styleSheets[0].cssRules;
myRules[0].insertRule(
  "html {background-color: blue;}",
  0,
); /* inserts a rule for the HTML element at position 0 */

Spezifikationen

Specification
CSS Object Model (CSSOM)
# dom-cssgroupingrule-insertrule

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
insertRule

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support