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; 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