diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/zh-cn/web/css/@document | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/zh-cn/web/css/@document')
-rw-r--r-- | files/zh-cn/web/css/@document/index.html | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/files/zh-cn/web/css/@document/index.html b/files/zh-cn/web/css/@document/index.html new file mode 100644 index 0000000000..0f15af0f55 --- /dev/null +++ b/files/zh-cn/web/css/@document/index.html @@ -0,0 +1,86 @@ +--- +title: '@document' +slug: Web/CSS/@document +tags: + - CSS + - 参考 +translation_of: Web/CSS/@document +--- +<div>{{CSSRef}} {{ SeeCompatTable}}</div> + +<p><code>@document</code> <a href="/zh-CN/docs/Web/CSS">CSS</a> <a href="/zh-CN/docs/Web/CSS/At-rule">at-rule</a> 根据文档的 URL 限制其中包含的样式规则的作用范围。它主要是为用户定义的样式表(UserStyle)而设计的,但也可以在作者定义的样式表上使用。</p> + +<pre class="brush: css no-line-numbers">@document url("https://www.example.com/") { + h1 { + color: green; + } +} +</pre> + +<h2 id="语法">语法</h2> + +<p><code>@document</code> 规则可以指定一个或多个匹配函数。如果任何功能适用于给定的 URL,则该规则将对该URL生效。可用的函数如下:</p> + +<ul> + <li><code>url()</code>,匹配整个 URL。</li> + <li><code>url-prefix()</code>,匹配文档的 URL 是否以参数指定的值开头。</li> + <li><code>domain()</code>,匹配文档的域名是否为参数中指定的域名或者为它的子域名。</li> + <li><code>regexp()</code>,匹配文档的 URL 是否和参数中指定的<a href="/zh-CN/JavaScript/Guide/Regular_Expressions">正则表达式</a>匹配。该表达式必须匹配整个 URL。</li> +</ul> + +<p>提供给 <code>url()</code>、<code>url-prefix()</code>,和 <code>domain()</code> 函数的参数可以不使用引号括起来。但提供给 <code>regexp()</code> 函数的参数必须用引号括起来。</p> + +<p>提供给 <code>regexp()</code> 函数的正则表达式中的转义字符必须再次进行一次 CSS 转义。例如,一个点号(<code>.</code>),在正则表达式中匹配任意换行符之外的字母.如果想要匹配一个正真的点号,必须首先按照正则表达式的规则转义一次(变为 <code>\.</code>)然后在使用CSS的规则再转义一次(转换为<code>\\.</code>)。</p> + +<h2 id="例子">例子</h2> + +<pre class="brush: css">@document url(http://www.w3.org/), + url-prefix(http://www.w3.org/Style/), + domain(mozilla.org), + regexp("https:.*") +{ + /* 该条CSS规则会应用在下面的网页: + + URL为"http://www.w3.org/"的页面. + + 任何URL以"http://www.w3.org/Style/"开头的网页 + + 任何主机名为"mozilla.org"或者主机名以".mozilla.org"结尾的网页 + + 任何URL以"https:"开头的网页 */ + + /* 让上述网页变得超级丑 */ + body { + color: purple; + background: yellow; + } +} +</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">文档</th> + <th scope="col">状态</th> + <th scope="col">注释</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{ SpecName('CSS3 Conditional', '#at-document', '@document') }}</td> + <td>{{ Spec2('CSS3 Conditional') }}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("css.at-rules.document")}}</p> + +<h2 id="参见">参见</h2> + +<ul> + <li><a class="external" href="http://lists.w3.org/Archives/Public/www-style/2004Aug/0135">Per-site user style sheet rules</a> on the www-style mailing list.</li> + <li>The file <code><a class="external" href="http://www.mozilla.org/support/firefox/edit#content">userContent.css</a></code> is a user stylesheet on Gecko-based browsers.</li> +</ul> |