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 |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 支持 | 支持 | 未知 | 支持 | 支持 |