CSSRule - 代表一个 CSS 规则
CSSRule 接口代表一个 CSS 规则。它有几种类型规则,列在下面的类型常量部分。
CSSRule 接口中指定了所有规则共有的属性,而在特定规则类型中的属性在这些规则各自类型的接口中指定。
可以通过 CSSStyleSheet 的 cssRules 列表来获取 CSSRule 的引用。
所有 CSSRule 实例通用的属性
CSSRule.cssText
代表规则的文本表示,例如 “h1,h2 { font-size: 16pt }” 或 “@import'url'”。要访问或修改部分规则(例如,示例中的 “font-size” 的值),请使用 规则类型的专用接口 上的属性。
CSSRule.parentRule 只读
返回包含的规则,否则返回 null。例如。如果该规则是 @media 块内的样式规则,则父规则将是 CSSMediaRule。
CSSRule.parentStyleSheet 只读
返回包含该规则的样式表的 CSSStyleSheet 对象
CSSRule.type 只读
类型常量中的一个,指示 CSS 规则的类型。
常量
类型常量
CSSRule 接口指定了整数常量,可以与 CSSRule 的 type 属性一起使用来辨别规则类型(以及它实现的哪个专用接口)。这些常量和接口之间的关系是:
| 类型 | 值 | 规则特定的接口 | 备注和实例 |
|---|---|---|---|
CSSRule.STYLE_RULE |
1 |
CSSStyleRule |
最常见的一种规则:selector { prop1: val1; prop2: val2; }
|
CSSRule.IMPORT_RULE |
3 |
CSSImportRule |
一个 @ import 规则。(在文档完成之前,请参阅 Mozilla 源代码中的接口定义:CSSImportRule。) |
CSSRule.MEDIA_RULE |
4 |
CSSMediaRule |
|
CSSRule.FONT_FACE_RULE |
5 |
CSSFontFaceRule |
|
CSSRule.PAGE_RULE |
6 |
CSSPageRule |
|
CSSRule.KEYFRAMES_RULE |
7 |
CSSKeyframesRule
|
|
CSSRule.KEYFRAME_RULE |
8 |
CSSKeyframeRule
|
|
| 保留以供将来使用 | 9 |
应该用于定义未来的颜色配置文件 | |
CSSRule.NAMESPACE_RULE |
10 |
CSSNamespaceRule
|
|
CSSRule.COUNTER_STYLE_RULE |
11 |
CSSCounterStyleRule
|
|
CSSRule.SUPPORTS_RULE |
12 |
CSSSupportsRule |
|
CSSRule.DOCUMENT_RULE |
13 |
CSSDocumentRule
|
|
CSSRule.FONT_FEATURE_VALUES_RULE |
14 |
CSSFontFeatureValuesRule |
|
CSSRule.VIEWPORT_RULE |
15 |
CSSViewportRule
|
|
CSSRule.REGION_STYLE_RULE |
16 |
CSSRegionStyleRule
|
|
CSSRule.UNKNOWN_RULE |
0 |
CSSUnknownRule
|
|
CSSRule.CHARSET_RULE |
2 |
CSSCharsetRule
|
(在大多数浏览器中移除了。) |
最新的非正式常量列表可以在 CSSWG Wiki 上找到。
规范
| 规范 | 状态 | 备注 |
|---|---|---|
| CSS Object Model (CSSOM) CSSRule 的定义 |
工作草案 | 移除了 CHARSET_RULE 和 UNKNOWN_RULE 值。增加了 NAMESPACE_RULE 值。 |
| CSS Animations CSSRule 的定义 |
工作草案 | 增加了 KEYFRAMES_RULE 和 KEYFRAME_RULE 值。 |
| CSS Fonts Module Level 3 CSSRule 的定义 |
候选推荐 | 增加了 FONT_FEATURE_VALUES_RULE 值。 |
| CSS Counter Styles Level 3 CSSRule 的定义 |
候选推荐 | 增加了 COUNTER_STYLE_RULE 值。 |
| CSS Conditional Rules Module Level 3 CSSRule 的定义 |
候选推荐 | 增加了 SUPPORTS_RULE 值。( DOCUMENT_RULE 已被推送到 CSS 条件规则 4 级) |
| Document Object Model (DOM) Level 2 Style Specification CSSRule 的定义 |
已过时 | 初始定义。 |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 支持 | 支持 | 9 | 支持 | 支持 |
移动浏览器兼容性
| 特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 支持 | 支持 | 支持 | 未知 | 支持 | 支持 |