diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2021-12-15 01:36:56 +0900 |
---|---|---|
committer | potappo <potappo@gmail.com> | 2021-12-18 17:40:42 +0900 |
commit | dfaaff7663c242012f4e876cb431c0b6d0db4471 (patch) | |
tree | 0c8008850eb3b0d5ffd1e60e49e633a4a2d1e198 | |
parent | 9c5a02802788114921511c33c99f3a8f0d1e65cc (diff) | |
download | translated-content-dfaaff7663c242012f4e876cb431c0b6d0db4471.tar.gz translated-content-dfaaff7663c242012f4e876cb431c0b6d0db4471.tar.bz2 translated-content-dfaaff7663c242012f4e876cb431c0b6d0db4471.zip |
2021/09/09 時点の英語版に同期
-rw-r--r-- | files/ja/web/css/@supports/index.md | 219 |
1 files changed, 110 insertions, 109 deletions
diff --git a/files/ja/web/css/@supports/index.md b/files/ja/web/css/@supports/index.md index f664508ed1..607bcd7147 100644 --- a/files/ja/web/css/@supports/index.md +++ b/files/ja/web/css/@supports/index.md @@ -2,198 +2,199 @@ title: '@supports' slug: Web/CSS/@supports tags: - - At-rule + - アットルール - CSS - - Layout - - Reference - - Web + - レイアウト + - リファレンス + - ウェブ - supports +browser-compat: css.at-rules.supports translation_of: Web/CSS/@supports --- -<div>{{CSSRef}}</div> +{{CSSRef}} -<p><strong><code>@supports</code></strong> は <a href="/ja/docs/Web/CSS">CSS</a> の <a href="/ja/docs/Web/CSS/At-rule">アット規則</a>で、宣言をブラウザーが1つまたは複数の特定の CSS 機能に対応しているかによって、宣言を指定することができます。これは<em>機能クエリ</em>と呼ばれます。規則はコードの最上位または他の<a href="/ja/docs/Web/CSS/At-rule#条件付きグループルール">条件付きグループアット規則</a>の中に配置することができます。</p> +**`@supports`** は [CSS](/ja/docs/Web/CSS) の[アットルール](/ja/docs/Web/CSS/At-rule)で、宣言をブラウザーが 1 つまたは複数の特定の CSS 機能に対応しているかによって、宣言を指定することができます。これは*機能クエリー*と呼ばれます。規則はコードの最上位または他の[条件付きグループアットルール](/ja/docs/Web/CSS/At-rule#条件付きグループルール)の中に配置することができます。 -<pre class="brush: css; no-line-numbers notranslate">@supports (display: grid) { +```css +@supports (display: grid) { div { display: grid; } -}</pre> +} +``` -<pre class="brush: css; no-line-numbers notranslate">@supports not (display: grid) { +```css +@supports not (display: grid) { div { float: right; } -}</pre> +} +``` -<p>JavaScript では <code>@supports</code> は CSS オブジェクトモデルインターフェイスの {{DOMxRef("CSSSupportsRule")}} からアクセスできます。</p> +JavaScript では `@supports` は CSS オブジェクトモデルインターフェイスの {{DOMxRef("CSSSupportsRule")}} からアクセスできます。 -<h2 id="Syntax" name="Syntax">構文</h2> +## 構文 -<p><code>@supports</code> アット規則は、ステートメントのブロックを<em>対応条件</em>に関連付けます。対応条件は1つまたは複数の名前と値の組を結合条件 (<code>and</code>)、非結合条件(<code>or</code>)、否定 (<code>not</code>) で組み合わせたものです。演算子の結合順位は、括弧を使用して変更できます。</p> +`@supports` アットルールは、文のブロックを*対応条件*に関連付けます。対応条件は 1 つまたは複数の名前と値の組を結合条件 (`and`)、非結合条件 (`or`)、否定 (`not`) で組み合わせたものです。演算子の結合順位は、括弧を使用して変更できます。 -<h3 id="Declaration_syntax" name="Declaration_syntax">宣言の構文</h3> +### 宣言の構文 -<p>もっとも基本的な対応条件は、単純な宣言 (プロパティ名に続けて、コロンで区切って値) です。宣言は括弧で囲む必要があります。以下の例は、ブラウザーが {{CSSxRef("transform-origin")}} プロパティの値として <code>5% 5%</code> を有効とみなすのであれば true を返します。</p> +もっとも基本的な対応条件は、単純な宣言 (プロパティ名に続けて、コロンで区切って値) です。宣言は括弧で囲む必要があります。以下の例は、ブラウザーが {{CSSxRef("transform-origin")}} プロパティの値として `5% 5%` を有効とみなすのであれば true を返します。 -<pre class="brush: css notranslate">@supports (transform-origin: 5% 5%) {}</pre> +```css +@supports (transform-origin: 5% 5%) {} +``` -<h3 id="Function_syntax" name="Function_syntax">関数構文</h3> +### 関数構文 -<p>第二の基本的な対応状況は関数の対応であり、これらの構文はすべてのブラウザーで対応されていますが、関数自体はまだ標準化の過程にあります。</p> +第二の基本的な対応状況は関数の対応であり、これらの構文はすべてのブラウザーで対応されていますが、関数自体はまだ標準化の過程にあります。 -<h4 id="selector" name="selector()"><code>selector()</code> {{Experimental_Inline}}</h4> +#### `selector()` {{Experimental_Inline}} -<p>ブラウザーがテストされたセレクターの構文に対応しているかどうかを検査します。以下の例は、ブラウザーが<a href="/ja/docs/Web/CSS/Child_combinator">子結合子</a>に対応していれば true を返します。</p> +ブラウザーがテストされたセレクターの構文に対応しているかどうかを検査します。以下の例は、ブラウザーが[子結合子](/ja/docs/Web/CSS/Child_combinator)に対応していれば true を返します。 -<pre class="brush: css notranslate">@supports selector(A > B) {}</pre> +```css +@supports selector(A > B) {} +``` -<h3 id="The_not_operator" name="The_not_operator">not 演算子</h3> +### not 演算子 -<p><code>not</code> 演算子は、新たな式を作成するために任意の式の前に置くことができ、元の式を否定します。以下の例は、ブラウザーが {{CSSxRef("transform-origin")}} プロパティの値として <code>10em 10em 10em</code> を有効と<strong>みなさない</strong>のであれば true を返します。</p> +`not` 演算子は、新たな式を作成するために任意の式の前に置くことができ、元の式を否定します。以下の例は、ブラウザーが {{CSSxRef("transform-origin")}} プロパティの値として `10em 10em 10em` を有効と**みなさない**のであれば true を返します。 -<pre class="brush: css notranslate">@supports not (transform-origin: 10em 10em 10em) {}</pre> +```css +@supports not (transform-origin: 10em 10em 10em) {} +``` -<p>他の演算子と同様に、 <code>not</code> 演算子はどれだけ複雑な宣言にも適用できます。以下の例はすべて有効な式です。</p> +他の演算子と同様に、 `not` 演算子はどれだけ複雑な宣言にも適用できます。以下の例はすべて有効な式です。 -<pre class="brush: css notranslate">@supports not (not (transform-origin: 2px)) {} -@supports (display: grid) and (not (display: inline-grid)) {}</pre> +```css +@supports not (not (transform-origin: 2px)) {} +@supports (display: grid) and (not (display: inline-grid)) {} +``` -<div class="blockIndicator note style-wrap"> -<p><strong>注:</strong> <code>not</code> 演算子が最上位にある場合は、括弧でくくる必要はありません。 <code>and</code> や <code>or</code> といった他の演算子と組み合わせるときは、括弧が必須です。</p> -</div> +> **Note:** `not` 演算子が最上位にある場合は、括弧でくくる必要はありません。 `and` や `or` といった他の演算子と組み合わせるときは、括弧が必須です。 -<h3 id="The_and_operator" name="The_and_operator">and 演算子</h3> +### and 演算子 -<p><code>and</code> 演算子は 2 つの式から、元の式の論理積で構成される新たな式を作成します。元の式の両方が true になる場合に限り、新たな式が true になります。以下の例では 2 つの式が同時に true になる場合に限り、全体の式も true になります。</p> +`and` 演算子は 2 つの式から、元の式の論理積で構成される新たな式を作成します。元の式の両方が true になる場合に限り、新たな式が true になります。以下の例では 2 つの式が同時に true になる場合に限り、全体の式も true になります。 -<pre class="brush: css notranslate">@supports (display: table-cell) and (display: list-item) {}</pre> +```css +@supports (display: table-cell) and (display: list-item) {} +``` -<p>括弧を増やすことなく、複数の論理積を並記することができます。以下の式はどちらも等価です。</p> +括弧を増やすことなく、複数の論理積を並記することができます。以下の式はどちらも等価です。 -<pre class="brush: css notranslate">@supports (display: table-cell) and (display: list-item) and (display:run-in) {} -@supports (display: table-cell) and ((display: list-item) and (display:run-in)) {}</pre> +```css +@supports (display: table-cell) and (display: list-item) and (display:contents) {} +@supports (display: table-cell) and ((display: list-item) and (display:contents)) {} +``` -<h3 id="The_or_operator" name="The_or_operator">or 演算子</h3> +### or 演算子 -<p><code>or</code> 演算子は 2 つの式から、元の式の論理和で構成される新たな式を作成します。元の式の一方または両方が true になる場合に限り、新たな式が true になります。以下の例では 2 つの式の少なくとも 1 つが true になる場合に限り、全体の式も true になります。</p> +`or` 演算子は 2 つの式から、元の式の論理和で構成される新たな式を作成します。元の式の一方または両方が true になる場合に限り、新たな式が true になります。以下の例では 2 つの式の少なくとも 1 つが true になる場合に限り、全体の式も true になります。 -<pre class="brush: css notranslate">@supports (transform-style: preserve) or (-moz-transform-style: preserve) {}</pre> +```css +@supports (transform-style: preserve) or (-moz-transform-style: preserve) {} +``` -<p>括弧を増やすことなく、複数の論理和を並記することができます。以下の式はどちらも等価です。</p> +括弧を増やすことなく、複数の論理和を並記することができます。以下の式はどちらも等価です。 -<pre class="brush: css notranslate">@supports (transform-style: preserve) or (-moz-transform-style: preserve) or +```css +@supports (transform-style: preserve) or (-moz-transform-style: preserve) or (-o-transform-style: preserve) or (-webkit-transform-style: preserve) {} @supports (transform-style: preserve-3d) or ((-moz-transform-style: preserve-3d) or ((-o-transform-style: preserve-3d) or (-webkit-transform-style: preserve-3d))) {} -</pre> +``` -<div class="blockIndicator note"> -<p><strong>注</strong>: <code>and</code> 演算子と <code>or</code> 演算子を両方とも使用するときは、これらを適用する順序を定義するために括弧を使用しなければなりません。そうしなければ、アット規則全体を無視させる無効な条件になります。</p> -</div> +> **Note:** `and` 演算子と `or` 演算子を両方とも使用するときは、これらを適用する順序を定義するために括弧を使用しなければなりません。そうしなければ、アットルール全体を無視させる無効な条件になります。 -<h2 id="Formal_syntax" name="Formal_syntax">形式文法</h2> +## 形式文法 {{CSSSyntax}} -<h2 id="Examples" name="Examples">例</h2> +## 例 -<h3 id="Testing_for_the_support_of_a_given_CSS_property" name="Testing_for_the_support_of_a_given_CSS_property">指定した CSS プロパティの対応状況を確認する</h3> +### 指定した CSS プロパティの対応状況を確認 -<pre class="brush: css notranslate">@supports (animation-name: test) { +```css +@supports (animation-name: test) { … /* 接頭辞がないプロパティでアニメーションに対応する場合に適用する CSS */ - @keyframes { /* 他のアット規則を含むことができる */ + @keyframes { /* 他のアットルールを含むことができる */ … } } -</pre> +``` -<h3 id="Testing_for_the_support_of_a_given_CSS_property_or_a_prefixed_version" name="Testing_for_the_support_of_a_given_CSS_property_or_a_prefixed_version">指定した CSS プロパティの対応状況を、接頭辞付きも含めて確認する</h3> +### 指定した CSS プロパティの対応状況を、接頭辞付きも含めて確認 -<pre class="brush: css notranslate">@supports ((perspective: 10px) or (-moz-perspective: 10px) or (-webkit-perspective: 10px) or +```css +@supports ((perspective: 10px) or (-moz-perspective: 10px) or (-webkit-perspective: 10px) or (-ms-perspective: 10px) or (-o-perspective: 10px)) { … /* 接頭辞つきを含めて 3D transforms を対応する場合に適用する CSS */ } -</pre> +``` -<h3 id="Testing_for_the_non-support_of_a_specific_CSS_property" name="Testing_for_the_non-support_of_a_specific_CSS_property">指定した CSS プロパティに対応していないことを確認する</h3> +### 指定した CSS プロパティに対応していないことを確認 -<pre class="brush: css notranslate">@supports not ((text-align-last: justify) or (-moz-text-align-last: justify)) { +```css +@supports not ((text-align-last: justify) or (-moz-text-align-last: justify)) { … /* text-align-last:justify をシミュレートするために適用する CSS */ -}</pre> +} +``` -<h3 id="Testing_for_the_custom_properties" name="Testing_for_the_custom_properties">カスタムプロパティの対応状況を確認する</h3> +### カスタムプロパティの対応状況を確認 -<pre class="brush: css notranslate">@supports (--foo: green) { +```css +@supports (--foo: green) { body { color: var(--varName); } -}</pre> +} +``` -<h3 id="Testing_for_the_support_of_a_selector" name="Testing_for_the_support_of_a_selector">セレクターの対応の検査 (例: {{CSSxRef(":is", ":is()")}})</h3> +### セレクターの対応の検査 -<p>{{SeeCompatTable}}</p> +CSS Conditional Rules Level 4 仕様では、セレクターの対応を検査する機能が追加されています-例えば {{cssxref(":is",":is()") }}。 -<pre class="brush: css highlight[6, 14] notranslate">/* この規則は :is() に対応していないブラウザーでは適用されません */ -:is(ul, ol) > li { +```css +/* このルールは :is() に対応していないブラウザーでは適用されません */ +:is(ul, ol) > li { … /* :is(…) セレクターに対応している場合に CSS が適用される */ } @supports not selector(:is(a, b)) { /* :is() に対応していない場合の代替 */ - ul > li, - ol > li { + ul > li, + ol > li { … /* 上記のものは :is(…) に対応していないブラウザーのために展開しています */ } } -/* Note: By far, there's no browser that supports the `of` argument of :nth-child(…) */ +/* Note: 今のところ :nth-child(...) の `of` 引数に対応しているブラウザーはありません。 */ @supports selector(:nth-child(1n of a, b)) { - /* This rule needs to be inside the @supports block, otherwise - it will be partially applied in browsers which don't support - the `of` argument of :nth-child(…) is supported */ + /* このルールは @supports ブロックの中に記述する必要があります。 + nth-child(...)の `of` 引数に対応していないブラウザーでは、 + 部分的に適用されます。 */ :is( :nth-child(1n of ul, ol) a, - details > summary + details > summary ) { - … /* CSS applied when the :is(…) selector and - the `of` argument of :nth-child(…) are both supported */ + … /* :is(…) セレクターと :nth-child(…) の + 両方に対応している場合にのみ適用される CSS */ } } -</pre> - -<h2 id="Specifications" name="Specifications">仕様書</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("CSS4 Conditional", "#at-supports-ext", "@supports")}}</td> - <td>{{Spec2("CSS4 Conditional")}}</td> - <td><code>selector()</code> 関数を追加</td> - </tr> - <tr> - <td>{{SpecName("CSS3 Conditional", "#at-supports", "@supports")}}</td> - <td>{{Spec2("CSS3 Conditional")}}</td> - <td>初回定義</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("css.at-rules.supports")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/CSS/CSS_Conditional_Rules/Using_Feature_Queries">機能クエリの使用</a></li> - <li>JavaScript で同様のチェックを実行できる、CSSOM の {{DOMxRef("CSSSupportsRule")}} クラスおよび {{DOMxRef("CSS.supports()")}} メソッド</li> -</ul> +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [機能クエリーの使用](/ja/docs/Web/CSS/CSS_Conditional_Rules/Using_Feature_Queries) +- JavaScript で同様のチェックを実行できる、CSSOM の {{DOMxRef("CSSSupportsRule")}} クラスおよび {{DOMxRef("CSS.supports()")}} メソッド |