CSSGroupingRule: insertRule() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。
insertRule() は CSSGroupingRule インターフェイスのメソッドで、新しい CSS ルールを CSS ルールのリストへ追加します。
構文
js
insertRule(rule)
insertRule(rule, index)
引数
返値
新しいルールの位置です。
例外
IndexSizeErrorDOMException-
index が子 CSS ルールの数以上であった場合に発生します。
HierarchyRequestErrorDOMException-
CSS で規定された制約により、リストの指定された(ゼロ起点の)インデックス位置に新しいルールが挿入できない場合に発生します。
InvalidStateErrorDOMException-
新しいルールが
@namespaceアットルールで、子 CSS ルールのリストが@importアットルールと@namespaceアットルール以外のものを含んでいる場合に発生します。
例
js
let myRules = document.styleSheets[0].cssRules;
myRules[0].insertRule(
"html {background-color: blue;}",
0,
); /* HTML 要素に対するルールを位置 0 に挿入します。 */
仕様書
| 仕様書 |
|---|
| CSS Object Model (CSSOM)> # dom-cssgroupingrule-insertrule> |