Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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; 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 rule aufgrund einer CSS-Einschränkung nicht an dem angegebenen Index eingefügt werden kann.

HierarchyRequestError DOMException

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

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