From 16f1159a22cc52c4f6bb4d7df95d40b2619657a1 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 9 Oct 2021 00:15:17 +0900 Subject: Web/CSS/At-rule を更新 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 2021/08/13 時点の英語版に同期 - 外部からのフラグメントへのリンクも更新 --- files/ja/web/css/@charset/index.html | 2 +- files/ja/web/css/@font-face/index.html | 2 +- files/ja/web/css/@font-feature-values/index.html | 2 +- files/ja/web/css/@import/index.html | 2 +- files/ja/web/css/@media/index.html | 2 +- files/ja/web/css/@supports/index.html | 2 +- files/ja/web/css/at-rule/index.md | 153 ++++++++++++----------- 7 files changed, 86 insertions(+), 79 deletions(-) (limited to 'files/ja/web') diff --git a/files/ja/web/css/@charset/index.html b/files/ja/web/css/@charset/index.html index 570f4bc9c0..2a57f026b1 100644 --- a/files/ja/web/css/@charset/index.html +++ b/files/ja/web/css/@charset/index.html @@ -11,7 +11,7 @@ translation_of: Web/CSS/@charset ---
{{CSSRef}}
-

CSS の @charset at-規則 は、スタイルシートで使う文字エンコーディングを定義します。この規則はスタイルシートの最初の要素でなければならず、これより前には文字を一切記述してはいけません。入れ子の文 でないとしても、条件付きグループ規則 では使えません。複数の @charset at-規則が定義されると、最初のものだけが使われます。HTML 要素の style 属性や、HTML ページの文字セットが関係している {{HTMLElement("style")}} 要素の中では使えません。

+

CSS の @charset at-規則 は、スタイルシートで使う文字エンコーディングを定義します。この規則はスタイルシートの最初の要素でなければならず、これより前には文字を一切記述してはいけません。入れ子の文 でないとしても、条件付きグループルール では使えません。複数の @charset at-規則が定義されると、最初のものだけが使われます。HTML 要素の style 属性や、HTML ページの文字セットが関係している {{HTMLElement("style")}} 要素の中では使えません。

@charset "utf-8";
diff --git a/files/ja/web/css/@font-face/index.html b/files/ja/web/css/@font-face/index.html index 3c0d73221b..593910fd2e 100644 --- a/files/ja/web/css/@font-face/index.html +++ b/files/ja/web/css/@font-face/index.html @@ -19,7 +19,7 @@ translation_of: Web/CSS/@font-face

url() と local() を両方とも使用することは一般的であり、そうすることでユーザーのインストールされたフォントのコピーが利用できればそれを利用し、ユーザーの端末に見つからない場合はフォントのコピーを代替としてダウンロードすることができます。

-

@font-face @-規則は、 CSS の最上位だけでなく、 CSS の条件付き @-規則グループの中でも使用することができます。

+

@font-face @-規則は、 CSS の最上位だけでなく、 CSS の条件付き @-規則グループの中でも使用することができます。

@font-face {
   font-family: "Open Sans";
diff --git a/files/ja/web/css/@font-feature-values/index.html b/files/ja/web/css/@font-feature-values/index.html
index 392dfefed5..d84fd3303b 100644
--- a/files/ja/web/css/@font-feature-values/index.html
+++ b/files/ja/web/css/@font-feature-values/index.html
@@ -12,7 +12,7 @@ translation_of: Web/CSS/@font-feature-values
 
 
@font-feature-values は CSS のアット規則で、OpenType で有効化された特性が異なるものに対して {{cssxref("font-variant-alternates")}} プロパティで共通の名前を使用することができます。これは、複数のフォントを使用している場合に CSS を簡素化するのに役立ちます。

 
-
@font-feature-values アット規則は、CSS の最上位で使用することも、任意の CSS の条件付きグループアット規則の内部で使用することもできます。

+
@font-feature-values アット規則は、CSS の最上位で使用することも、任意の CSS の条件付きグループアット規則の内部で使用することもできます。

 
 
構文

 
diff --git a/files/ja/web/css/@import/index.html b/files/ja/web/css/@import/index.html
index 3fbaa9a92d..79081a08d0 100644
--- a/files/ja/web/css/@import/index.html
+++ b/files/ja/web/css/@import/index.html
@@ -12,7 +12,7 @@ translation_of: Web/CSS/@import
 ---
 
{{CSSRef}}

 
-
CSS の @import @-規則 は、他のスタイルシートから {{CSSxRef("@charset")}} を除いたスタイル規則をインポートするために使用します。これは入れ子になるステートメントではないので、 @import は条件付き @-規則グループの中で使うことはできません。

+
CSS の @import @-規則 は、他のスタイルシートから {{CSSxRef("@charset")}} を除いたスタイル規則をインポートするために使用します。これは入れ子になるステートメントではないので、 @import は条件付き @-規則グループの中で使うことはできません。

 
 
@import url("fineprint.css") print;
 @import url("bluish.css") speech;
diff --git a/files/ja/web/css/@media/index.html b/files/ja/web/css/@media/index.html
index 222098da50..b335cc8467 100644
--- a/files/ja/web/css/@media/index.html
+++ b/files/ja/web/css/@media/index.html
@@ -19,7 +19,7 @@ translation_of: Web/CSS/@media
 
 
構文

 
-
@media @-規則は、コードの最上位に配置したり、他の条件付きグループ @-規則の中に入れ子にして配置したりすることができます。

+
@media @-規則は、コードの最上位に配置したり、他の条件付きグループ @-規則の中に入れ子にして配置したりすることができます。

 
 
/* コードの最上位 */
 @media screen and (min-width: 900px) {
diff --git a/files/ja/web/css/@supports/index.html b/files/ja/web/css/@supports/index.html
index 34320c8394..f664508ed1 100644
--- a/files/ja/web/css/@supports/index.html
+++ b/files/ja/web/css/@supports/index.html
@@ -12,7 +12,7 @@ translation_of: Web/CSS/@supports
 ---
 
{{CSSRef}}

 
-
@supports は CSS の アット規則で、宣言をブラウザーが1つまたは複数の特定の CSS 機能に対応しているかによって、宣言を指定することができます。これは機能クエリと呼ばれます。規則はコードの最上位または他の条件付きグループアット規則の中に配置することができます。

+
@supports は CSS の アット規則で、宣言をブラウザーが1つまたは複数の特定の CSS 機能に対応しているかによって、宣言を指定することができます。これは機能クエリと呼ばれます。規則はコードの最上位または他の条件付きグループアット規則の中に配置することができます。

 
 
@supports (display: grid) {
   div {
diff --git a/files/ja/web/css/at-rule/index.md b/files/ja/web/css/at-rule/index.md
index 6d4fdbcd1d..42e4568a4b 100644
--- a/files/ja/web/css/at-rule/index.md
+++ b/files/ja/web/css/at-rule/index.md
@@ -1,85 +1,92 @@
 ---
-title: '@-規則'
+title: アットルール
 slug: Web/CSS/At-rule
 tags:
-  - '@-規則'
-  - '@規則'
   - CSS
-  - CSS リファレンス
+  - ガイド
   - Reference
-  - アット規則
 translation_of: Web/CSS/At-rule
 ---
-
{{cssref}}

+{{CSSRef}}
 
-
@-規則 は CSS 文 の一つで、 CSS の振舞いを規定します。 @-規則は、アットマーク、 '@' (U+0040 COMMERCIAL AT) で始まり、それに続く識別子から、次のセミコロン、 ';' (U+003B SEMICOLON) もしくは次の CSS ブロックのどちらかが現れるまでの部分からなります。

+**アットルール**は [CSS 文](/ja/docs/Web/CSS/Syntax#css_statements)のうち、CSS の動作を既定するものです。アットルールはアットマーク、'`@`' (`U+0040 COMMERCIAL AT`) で始まり、それに続く識別子から、次のセミコロン、 '`;`' (`U+003B SEMICOLON`) もしくは次の [CSS ブロック](/ja/docs/Web/CSS/Syntax#css_declarations_blocks)のどちらかが現れるまでの部分からなります。
 
-
/* 一般的な構造 */
+## 構文
+
+### 通常
+
+```css
+/* 一般的な構造 */
 @IDENTIFIER (RULE);
 
 /* 例: ブラウザーに UTF-8 文字セットを使用することを知らせる */
-@charset "utf-8";

-
-
@-規則は何種類かあり、識別子で区別され、それぞれに異なる構文が使用されます:

-
-
    
- 
  • {{cssxref("@charset")}} — スタイルシートで使用される文字セットを定義します。
    • 
- 
  • {{cssxref("@import")}} — 外部のスタイルシートを読み込むよう CSS エンジンに指示します。
    • 
- 
  • {{cssxref("@namespace")}} — CSS エンジンに、内容のすべてに XML 名前空間の接頭辞がついていると見なすよう指示します。
    • 
- 
  • 入れ子状の @-規則 — 入れ子になった文のサブセットになります。スタイルシートの文としてだけではなく、条件付きグループ規則の内部で使用されます:
-  
      
-   
    • {{cssxref("@media")}} — メディアクエリの条件を満たすデバイスで読み込まれた場合にこれの中身が適用される、条件付きグループ規則です。
      • 
-   
    • {{cssxref("@supports")}} — ブラウザーが指定の条件を満たす場合にこれの中身が適用される、条件付きグループ規則です。
      • 
-   
    • {{cssxref("@document")}} {{experimental_inline}} — このスタイルシートが適用される文書が、与えられた条件を満たす場合に、これの中身が適用される条件付きグループ規則です。(CSS Level 4 仕様に先送り)
      • 
-   
    • {{cssxref("@page")}} — 文書印刷の際に適用されるレイアウト変更に関する指定を記述します。
      • 
-   
    • {{cssxref("@font-face")}} — ダウンロードすべき外部フォントに関する指定を記述します。
      • 
-   
    • {{cssxref("@keyframes")}} — CSS アニメーションシーケンスの中間ステップに関する指定を記述します。
      • 
-   
    • {{cssxref("@viewport")}} {{experimental_inline}} — 小さな画面のデバイス用に、ビューポートに関する指定を記述します。(現在は Working Draft 段階)
      • 
-   
    • {{cssxref("@counter-style")}} — 定義済みのスタイルにはない、独自のカウンタースタイルを定義します。(勧告候補段階ですが、現時点で Gecko しか実装していません)
      • 
-   
    • {{cssxref("@font-feature-values")}} (および @swash, @ornaments, @annotation, @stylistic, @styleset, @character-variant)
      
-    — OpenType の各機能を有効化するために、 {{cssxref("font-variant-alternates")}} の一般名を定義します。(勧告候補段階ですが、現時点で Gecko しか実装していません)
      • 
-  
    
- 
    • 
-

-
-
条件付きグループ規則

-
-
プロパティの値のように、各 @-規則は異なる構文を持ちます。しかし、いくつかの @-規則は 条件付きグループ規則という特別なカテゴリに分類されます。条件付きグループ規則の文は、構文が共通していて、どれも入れ子の文を持つことができ、ここには普通のルールセットはもちろん、さらに入れ子の @-規則を含める事ができます。さらに言えば、それらはすべて共通の意味あいがあります。 — 全ては常に真か偽と判定される何らかの条件と結びついています。条件が真であれば、条件付きグループ規則内の文全部が適用されます。

-
-
条件付きグループ規則は CSS Conditionals Level 3 で定義されており、以下の規則があります。

-
-
    
- 
  • {{cssxref("@media")}}
    • 
- 
  • {{cssxref("@supports")}}
    • 
- 
  • {{cssxref("@document")}} (CSS Level 4 仕様に先送り)
    • 
-

-
-
条件付きグループは、入れ子状の文を持ち、いくつでも入れ子にすることができます。

-
-
仕様書

-
-
- 
-  
-   
-   
-   
-  
-  
-   
-   
-   
-  
-  
-   
-   
-   
-  
- 
-
仕様書状態備考
{{SpecName('CSS3 Conditional')}}{{Spec2('CSS3 Conditional')}}初回定義
{{SpecName('Compat', '#css-at-rules', 'CSS At-rules')}}{{Spec2('Compat')}}@-webkit-keyframes を標準化

-
-
関連情報

-
-
    
- 
  • {{CSS_key_concepts}}
    • 
-

+@charset "utf-8";
+```
+
+アットルールは何種類かあり、識別子で区別され、それぞれに異なる構文が使用されます。
+
+- {{cssxref("@charset")}} — スタイルシートで使用される文字セットを定義します。
+- {{cssxref("@import")}} — 外部のスタイルシートを読み込むよう CSS エンジンに指示します。
+- {{cssxref("@namespace")}} — CSS エンジンに、内容のすべてに XML 名前空間の接頭辞がついていると見なすよう指示します。
+
+### 入れ子
+
+```css
+@IDENTIFIER (RULE) {
+
+}
+```
+
+入れ子になった文のサブセットになります。スタイルシートの文としてだけではなく、条件付きグループルールの内部で使用されます。
+
+- {{cssxref("@media")}} — *メディアクエリ*の条件を満たす端末で読み込まれた場合にこれの中身が適用される、条件付きグループルールです。
+- {{cssxref("@supports")}} — ブラウザーが指定の条件を満たす場合にこれの中身が適用される、条件付きグループルールです。
+- {{cssxref("@document")}} {{deprecated_inline}} — このスタイルシートが適用される文書が、与えられた条件を満たす場合に、これの中身が適用される条件付きグループルールです。 _(CSS Level 4 仕様に先送り)_
+- {{cssxref("@page")}} — 文書印刷の際に適用されるレイアウト変更に関する指定を記述します。
+- {{cssxref("@font-face")}} — ダウンロードすべき外部フォントに関する指定を記述します。
+- {{cssxref("@keyframes")}} — CSS アニメーションシーケンスの中間段階に関する指定を記述します。
+- {{cssxref("@viewport")}} {{deprecated_inline}} — 小さな画面の端末用に、ビューポートに関する指定を記述します。 _(現在は草稿段階)_
+- {{cssxref("@counter-style")}} — 定義済みのスタイルにはない、独自のカウンタースタイルを定義します。_(勧告候補段階ですが、現時点で Gecko しか実装していません)_
+- {{cssxref("@font-feature-values")}} (および `@swash`, `@ornaments`, `@annotation`, `@stylistic`, `@styleset`, `@character-variant`) — OpenType の各機能を有効化するために、 {{cssxref("font-variant-alternates")}} の一般名を定義します。_(勧告候補段階ですが、現時点で Gecko しか実装していません)_
+- {{cssxref("@property")}} {{experimental_inline}} — カスタムプロパティと変数に関して指定します。 _(現在は草稿段階)_
+- {{cssxref("@color-profile")}} {{experimental_inline}} — {{cssxref("color_value/color()", "color()")}} 関数で使用するカラープロファイルを定義できます。
+
+## 条件付きグループルール
+
+プロパティの値と同様に、アットルールはそれぞれ異なる構文を持っています。しかし、いくつかのアットルールは **条件付きグループルール**という特別なカテゴリーに分類されます。これらの文は構文が共通しており、どれも*内側の文*—*規則セット*または*内側のアットルール*を入れることができます。さらに言えば、それらはすべて共通の意味合いがあります。 — すべては常に**真**か**偽**かで判定される何らかの条件と結びついています。条件が**真**であれば、条件付きグループルール内の文全部が適用されます。
+
+条件付きグループルールは  [CSS Conditionals Level 3](https://dev.w3.org/csswg/css3-conditional/) で定義されており、以下の規則があります。
+
+- {{cssxref("@media")}}
+- {{cssxref("@supports")}}
+- {{cssxref("@document")}} _(CSS Level 4 仕様に先送り)_
+
+条件付きグループは、入れ子状の文を持ち、いくつでも入れ子にすることができます。
+
+## 索引
+
+- {{cssxref("@charset")}}
+- {{cssxref("@color-profile")}} {{experimental_inline}}
+- {{cssxref("@counter-style")}}
+- {{cssxref("@document")}} {{deprecated_inline}}
+- {{cssxref("@font-face")}}
+- {{cssxref("@font-feature-values")}}
+- {{cssxref("@import")}}
+- {{cssxref("@keyframes")}}
+- {{cssxref("@media")}}
+- {{cssxref("@namespace")}}
+- {{cssxref("@page")}}
+- {{cssxref("@property")}} {{experimental_inline}}
+- {{cssxref("@supports")}}
+- {{cssxref("@viewport")}} {{deprecated_inline}}
+
+## 仕様書
+
+| 仕様書                                                  | 状態                          | 備考                          |
+| ------------------------------------------------------- | ----------------------------- | ----------------------------- |
+| {{SpecName('CSS3 Conditional')}}                        | {{Spec2('CSS3 Conditional')}} | 初回定義                      |
+| {{SpecName('Compat', '#css-at-rules', 'CSS At-rules')}} | {{Spec2('Compat')}}           | `@-webkit-keyframes` を標準化 |
+
+## 関連情報
+
+- {{CSS_key_concepts}}
-- 
cgit v1.2.3-54-g00ecf