CSSStyleSheet: addRule() Methode
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Die veraltete Methode addRule() des CSSStyleSheet Schnittstelle fügt ein neue Regel zum Stylesheet hinzu. Sie sollten diese Methode vermeiden und stattdessen die standardmäßigere Methode insertRule() verwenden.
Syntax
addRule(selector, styleBlock, index)
Parameter
selector-
Ein String, der den Selektor-Teil der CSS-Regel angibt. Der Standardwert ist der String
undefined. styleBlock-
Ein String, der den Stilblock angibt, der auf die Elemente angewendet werden soll, die dem
selectorentsprechen. Der Standardwert ist der Stringundefined. indexOptional-
Ein optionaler Index in der
CSSRuleListdes Stylesheets, an dem die neue Regel eingefügt werden soll. Wennindexnicht angegeben ist, wird der nächste Index nach dem letzten derzeit in der Liste befindlichen Element verwendet (das ist der Wert voncssStyleSheet.cssRules.length).
Rückgabewert
Gibt immer -1 zurück.
Beachten Sie, dass aufgrund einiger etwas komplexer Regeln dazu, wo Regeln rechtlich eingefügt werden können, möglicherweise eine Ausnahme ausgelöst wird. Weitere Informationen finden Sie unter insertRule().
Verwendungshinweise
Diese Methode wird von Browsern implementiert, indem ein String mit der Template Literal `${selector}{${styleBlock}}` erstellt und dann an die Standardmethode insertRule() übergeben wird.
Daher kann vorhandener Code wie der folgende:
cssStyleSheet.addRule(selector, styles, 0);
umgeschrieben werden, um die standardmäßigere insertRule() Methode zu verwenden, wie folgt:
cssStyleSheet.insertRule(`${selector} {${styles}}`, 0);
Spezifikationen
| Spezifikation |
|---|
| CSS Object Model (CSSOM) # dom-cssstylesheet-addrule |