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 April 2021.

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; Standard ist 0.

Rückgabewert

Der Index der neuen Regel.

Ausnahmen

IndexSizeError DOMException

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

HierarchyRequestError DOMException

Wird ausgelöst, wenn rule aufgrund einer CSS-Einschränkung nicht an der angegebenen Stelle eingefügt werden kann.

HierarchyRequestError DOMException

Wird ausgelöst, wenn die rule eine gültige Anweisung ist, aber keine verschachtelte Anweisung darstellt.

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