@document

语法

@document 规则可以指定一个或多个匹配函数。如果其中的任何函数适用于给定的 URL，则该规则将对该 URL 生效。可用的函数如下：

url()

匹配完全相符的 URL。

url-prefix()

匹配文档的 URL 是否以参数指定的值开头。

domain()

匹配文档的域名是否为参数中指定的域名或者为它的子域名。

media-document()

根据参数中的字符串匹配媒体查询，匹配其中之一：video、image、plugin 或 all。

regexp() 已弃用 非标准

匹配文档的 URL 是否和参数中指定的正则表达式匹配，该表达式必须匹配整个 URL。

提供给 url()、url-prefix()、domain() 和 media-document() 函数的参数可以不使用引号括起来。但提供给 regexp() 函数的参数必须用引号括起来。

提供给 regexp() 函数的正则表达式中的转义字符必须再次进行一次 CSS 转义。例如，一个句号（.）在正则表达式中匹配任何字符。如果想要匹配一个真正的句号，必须首先按照正则表达式的规则转义一次（变为 \.）然后再使用 CSS 规则对该字符串进行转义（转换为 \\.）。

@document 目前只在 Firefox 火狐浏览器中支持。如果你想在非 Firefox 火狐浏览器中使用此功能，你可以尝试使用由 @An-Error94 提供的 polyfill，它使用了用户脚本、data-* 属性和属性选择器的组合。

形式语法

@document [ <url>                    |
            url-prefix(<string>)     |
            domain(<string>)         |
            media-document(<string>) |
            regexp(<string>)
          ]# {
  <group-rule-body>
}

示例

指定 CSS 规则的文档

@document url("http://www.w3.org/"),
          url-prefix("http://www.w3.org/Style/"),
          domain("mozilla.org"),
          media-document("video"),
          regexp("https:.*") {
  /* 这里适用的 CSS 规则：
     - 页面为“http://www.w3.org/”
     - 任何 URL 以“http://www.w3.org/Style/”开头的页面
     - 任何 URL 的主机为“mozilla.org”或以“.mozilla.org”结尾的页面
     - 任何独立视频
     - 任何以“https:”开头的页面 */

  /* 让上述网页变得超级丑 */
  body {
    color: purple;
    background: yellow;
  }
}

规范

@document 在第三版中开始拟定标准，并在后来被推迟到第 4 版，但随后被移除。

浏览器兼容性

参见

• www-style 邮件列表中的各网站用户样式表规则。