CSSGroupingRule: insertRule() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.
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
indexOptional-
Ein optionaler Index, an dem die Regel eingefügt werden soll; standardmäßig 0.
Rückgabewert
Der Index der neuen Regel.
Ausnahmen
IndexSizeErrorDOMException-
Wird ausgelöst, wenn index größer als die Anzahl der untergeordneten CSS-Regeln ist.
HierarchyRequestErrorDOMException-
Wird ausgelöst, wenn
ruleaufgrund einer CSS-Einschränkung nicht an dem angegebenen Index eingefügt werden kann. HierarchyRequestErrorDOMException-
Wird ausgelöst, wenn die
ruleeine 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
| Spezifikation |
|---|
| CSS Object Model (CSSOM) # dom-cssgroupingrule-insertrule |