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

BCD tables only load in the browser