@document

@document 規則は、ドキュメントの URL に基づいて、その中に含まれるスタイル規則を制限する CSS の @ 規則 です。これは主にユーザー定義スタイルシート用に設計されていますが、著者定義スタイルシートにも使えます。

@document url("https://www.example.com/") {
  h1 {
    color: green;
  }
}

構文

@document 規則には 1 つ以上のマッチング関数を指定します。関数が URL に適用されると、規則がその URL に効果を及ぼします。利用可能な関数は次の通りです:

• url()。正確な URL にマッチします
• url-prefix()。URL が、与えた値で始まるときマッチします
• domain()。URL が、与えたドメイン内のもの (またはサブドメインのもの) であるときマッチします
• regexp()。URL が、与えた 正規表現 にマッチするときにマッチします。正規表現は URL 全体にマッチする必要があります。

url()、url-prefix()、および domain() 関数に与える値は、単一引用符または二重引用符で囲うこともできます。regexp() 関数に与える値は、引用符で囲わねばなりません。

regexp() 関数に与えるエスケープされた値は CSS によってさらにエスケープされる必要があります。例えば、一つの . (ピリオド) は正規表現ではどんな文字にもマッチします。リテラルのピリオドにマッチさせるには、まず正規表現の規則を使ってエスケープし（\. にします）、次に CSS の規則を使ってエスケープしなければなりません（\\. にします）。

Formal syntax

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

例

CSS

@document url(http://www.w3.org/),
          url-prefix(http://www.w3.org/Style/),
          domain(mozilla.org),
          regexp("https:.*") {
  /* この CSS 規則を次のページに適用:
     + "http://www.w3.org/" ページ。
     + "http://www.w3.org/Style/" で始まる URL のページ。
     + URL のホストが "mozilla.org" のページまたは ".mozilla.org" で終わるページ。
     + URL が "https:" で始まるページ。
   */

  /* 上で挙げたページを見辛くする */
  body {
    color: purple;
    background: yellow;
  }
}

仕様

CSS Conditional Rules Module Level 3 で 初めて登場 しました。@document は CSS4 に 延期されました。

ブラウザー実装状況

関連情報

• Per-site user style sheet rules on the www-style mailing list.

• ファイル userContent.css は Geckoベースのブラウザのユーザ定義スタイルシートです。