CSSOM
CSSStyleSheet.insertRule() 方法用来给当前样式表插入新的样式规则(CSS rule),并且包含一些限制。
[!NOTE] 尽管
insertRule()是 CSSStyleSheet 的一个方法,但它实际插入的地方是CSSStyleSheet.cssRules的内部 CSSRuleList。
语法
insertRule(rule)
insertRule(rule, index)
参数
-
rule -
index- : 一个小于或等于
stylesheet.cssRules.length的正整数,表示新插入的规则在CSSStyleSheet.cssRules中的位置。默认值是0。(在过去的实现中,这个参数是必需的,详情参见浏览器兼容性。)
- : 一个小于或等于
返回值
新插入的规则在当前样式表规则列表中的索引。
限制
CSS 中存在一些直观和不是太直观能感受到的限制规则影响着某些样式规则能否被插入。违反这些规则可能会导致一些 DOM 异常(DOMException)。
- 如果
index>CSSRuleList.length,该方法会中止并返回一个IndexSizeError错误; - 如果
rule由于一些 CSS 约束而不能被插入到index0,该方法会中止并返回一个HierarchyRequestError错误; - 如果
rule参数中包含超过一条样式规则,该方法会中止并返回一个SyntaxError; - 如果尝试在一条普通规则后插入一条 @import 这种类型的规则,该方法会中止并返回一个
HierarchyRequestError错误; - 如果
rule是 @namespace 并且规则列表中有另外的@import和/或@namespace规则,该方法中止并返回一个InvalidStateError错误;
示例
在样式表顶部插入新的规则
下面的代码片段将在样式表 myStyle 的顶部插入一条新规则:
myStyle.insertRule("#blanc { color: white }", 0);
实现一个添加样式表规则的函数
/**
* 在文档中添加一条样式表规则(这可能是动态改变 class 名的更好的实现方法,
* 使得 style 样式内容可以保留在真正的样式表中,以便添加额外的元素到 DOM 中)。
* 注意这里有必要声明一个数组,因为 ECMAScript 不保证对象按预想的顺序遍历,
* 并且 CSS 也是依赖于顺序的。
* 类型为数组的参数 decls 接受一个 JSON 编译的数组。
* @example
addStylesheetRules([
['h2', // 还接受第二个参数作为数组中的数组
['color', 'red'],
['background-color', 'green', true] // 'true' for !important rules
],
['.myClass',
['background-color', 'yellow']
]
]);
*/
function addStylesheetRules(decls) {
var style = document.createElement("style");
document.getElementsByTagName("head")[0].appendChild(style);
if (!window.createPopup) {
/* For Safari */
style.appendChild(document.createTextNode(""));
}
var s = document.styleSheets[document.styleSheets.length - 1];
for (var i = 0, dl = decls.length; i < dl; i++) {
var j = 1,
decl = decls[i],
selector = decl[0],
rulesStr = "";
if (Object.prototype.toString.call(decl[1][0]) === "[object Array]") {
decl = decl[1];
j = 0;
}
for (var rl = decl.length; j < rl; j++) {
var rule = decl[j];
rulesStr +=
rule[0] + ":" + rule[1] + (rule[2] ? " !important" : "") + ";\n";
}
if (s.insertRule) {
s.insertRule(selector + "{" + rulesStr + "}", s.cssRules.length);
} else {
/* IE */
s.addRule(selector, rulesStr, -1);
}
}
}
规范
浏览器兼容性
参见
- CSSStyleSheet.deleteRule
- Cross-Browser CSS-rules ordering (CSS1)
- Quirksmode - CSS
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
