CSSの@supportsで、未対応のブラウザー向けの指定を分ける方法
新しい CSS を使いたいけれど、対応していない古いブラウザーでも表示が崩れないように、代わりの見た目(フォールバック)を用意しておきたい。そんなときは、代わりの指定をふつうに書いておき、新しい CSS に関わる指定だけを @supports で囲みます。対応しているブラウザーでは囲んだ中の指定が上書きし、対応していないブラウザーでは中がまるごと使われません。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。検証用のページを Playwright で開き、getComputedStyle() や getBoundingClientRect()、CSS.supports() の値を読みました。Chromium は新しい CSS に対応しているので、「対応していないブラウザー」は、@supports の条件やプロパティ名をどのブラウザーも知らないものに書き換えて再現しています。Firefox と Safari、古いバージョンのブラウザーそのものは試していません。
1つのプロパティだけなら、2回書けば足りる
切り替えたいのが1つのプロパティの値だけなら、@supports を使わなくても済みます。同じプロパティを2回書き、2つ目に新しい値を書きます。
.box {
background: #eefafd;
background: color-mix(in oklch, #00c8e8 20%, white);
}
ブラウザーは、読めない値の宣言を捨てます。検証環境で、2つ目の値を存在しない関数(no-such-function(...))に書き換えると、背景色の計算値は1つ目の rgb(238, 250, 253)(#eefafd)のままでした。書き換えないときは、2つ目の color-mix() の色になりました。
複数の指定をまとめて切り替えるときは @supports で囲む
2回書くやり方が使えないのは、新しい CSS に合わせて、ほかのプロパティも一緒に変えなければならないときです。例として、「?」ボタンの近くにヒントを出す部品を作ります。新しい position-area(アンカー配置)が使えるブラウザーではボタンの上に、使えないブラウザーではボタンの下に出します。
<div class="demo">
<button class="help-btn" type="button">?</button>
<p class="tip">保存すると、下書きは消えます</p>
</div>
/* 代わりの指定(どのブラウザーでも使われる) */
.demo {
position: relative;
}
.tip {
position: absolute;
top: calc(100% + 8px);
left: 0;
}
/* position-area に対応しているときだけ使われる指定 */
@supports (position-area: top span-right) {
.help-btn {
anchor-name: --help;
}
.tip {
position: fixed;
position-anchor: --help;
position-area: top span-right;
top: auto;
left: auto;
margin-bottom: 8px;
}
}
ヒントの position を fixed にしているのは、親の要素に overflow: hidden が付いていても、ヒントが切れずに見えるようにするためです。検証環境で .demo に overflow: hidden と height: 40px を付けると、@supports の中が使われたときはヒントが見えたままでした。中が使われないとき(absolute のまま)は、.demo の外にはみ出した部分が切り取られ、ヒントが見えなくなりました。
条件は、MDN の @supports のページにあるとおり、プロパティ: 値 の形でかっこに入れて書きます。@mdn/browser-compat-data 8.1.8 の互換性データでは、中に書いた anchor-name は Chrome・Edge 125、Firefox 147、Safari 26 から使え、position-area(Chrome・Edge 129、Firefox 147、Safari 26)と同じか、それより前のバージョンで入っています。position-anchor も、同じバージョンから一部の機能が使えます。そのため、ここでは position-area だけを条件にしました。

検証環境でボタンとヒントの位置を測った結果は次のとおりです。ボタンは、ページの上端から 64〜96px の位置にあります。
| CSS の状態 | ヒントの位置 | 200px スクロールしたあと |
|---|---|---|
| 対応している | ボタンの上(24〜56px) | ボタンと一緒に動いた |
対応していない・@supports で分けた |
ボタンの下(104〜136px) | ボタンと一緒に動いた |
対応していない・@supports で分けなかった |
ボタンのすぐ下(96〜128px) | 画面の同じ位置に残った |
3行目は、@supports で囲まずに同じ指定を書き、anchor-name・position-anchor・position-area だけをブラウザーが知らない名前に変えて、対応していないブラウザーを再現したものです。知らないプロパティは捨てられますが、position: fixed と top: auto はどのブラウザーも読めるので、そのまま使われます。その結果、ヒントは画面に固定され、スクロールしてもボタンについていかずに、ボタンから離れた位置に残りました。新しいプロパティと組み合わせて初めて意味を持つ指定は、一緒に @supports の中に入れておきます。
@supports の中で、代わりの指定を打ち消す
@supports の中で top: auto と left: auto を書いているのは、外で書いた代わりの指定(top: calc(100% + 8px) と left: 0)を打ち消すためです。この2行を消して試すと、ヒントは 72〜104px の位置に出て、ボタン(64〜96px)に重なりました。@supports の中に新しい指定を書いても、外で書いた指定が消えるわけではありません。中で上書きしなかったプロパティは、外の値がそのまま残ります。
@supports のブロックは、代わりの指定よりあとに書く
@supports で囲んでも、詳細度や順番の決まりはふつうのルールと同じです。@supports のブロックを代わりの指定より前に置くと、position はあとに書いた absolute になり、ヒントはボタンに重なる位置(72〜104px)に出ました。対応しているブラウザーで新しい指定を勝たせるには、代わりの指定を先に、@supports をあとに書きます。
条件の書き方
and・or・not で、条件を組み合わせられます。検証環境で、条件だけを変えた @supports のルールを読み込み、中の指定が使われたかを調べました。「ルールが消えた」は、CSSOM(sheet.cssRules)にルールが残らなかったことを表します。
| 条件 | 結果 |
|---|---|
(position-area: top) |
中が使われた |
(position-area: no-such-value) |
使われなかった |
not (position-area: no-such-value) |
中が使われた |
(display: grid) and (position-area: no-such-value) |
使われなかった |
(position-area: no-such-value) or (display: grid) |
中が使われた |
(display: grid) or (position-area: top) and (color: red) |
ルールが消えた |
((display: grid) or (position-area: top)) and (color: red) |
中が使われた |
not (display: grid) and (color: red) |
ルールが消えた |
display: grid(かっこなし) |
ルールが消えた |
(no-such-property: 1px) |
使われなかった |
and と or を混ぜるときや、not をほかの演算子と組み合わせるときは、かっこで順番をはっきりさせないと、ルールごと無視されます。MDN のページにも、and と or を混ぜるときにかっこがないと「アットルール全体を無視させる無効な条件になります」と書かれています。条件の宣言をかっこで囲み忘れた場合も、同じように消えました。
セレクターやフォントを条件にする
プロパティ: 値 の形のほかに、関数の形の条件も書けます。検証環境の Chromium 153 で、次の条件はどれも成り立ちました。
| 条件 | 調べること |
|---|---|
selector(:has(a)) |
そのセレクターを読めるか |
font-format(woff2) |
そのフォント形式に対応しているか |
font-tech(color-COLRv1) |
そのフォント技術に対応しているか |
at-rule(@starting-style) |
そのアットルールに対応しているか |
存在しない擬似クラス(selector(:no-such-pseudo))や、:has() を入れ子にしたセレクター(selector(.a:has(.b:has(.c))))は、成り立ちませんでした。at-rule(@no-such-rule) も同じです。
調べられるのは、その書き方をブラウザーが読めるかどうか
@supports は、宣言やセレクターをブラウザーが正しく読めるかを調べるものです。そのため、次のような条件は、書き方から予想する結果とは違う結果になりました。
(--anything: no-such-value)のようなカスタムプロパティの条件は、値に意味のない文字を書いても成り立った(display: grid !important)は成り立った。CSS の仕様(CSS Conditional Rules Module Level 3)にも、条件の宣言の最後に!importantを付けてよいと書かれている- 知らない関数の形(
no-such-function(1px))は、ルールは残ったうえで成り立たなかった。ところがnot no-such-function(1px)は成り立った
最後の点は、仕様の決まりどおりの動きです。仕様では、文法の上では読める形でもブラウザーが知らない条件は、ルールを無効にせず「偽」として扱うと定められています。そのため、not を付けると「真」になります。
新しい関数の形の条件に not を付けて、「対応していないときだけ使う指定」を書くときは注意が必要です。関数名を書き間違えると、ブラウザーはその関数を知らないものとして扱い、対応しているブラウザーでも not の中が使われます。検証環境では、存在しない関数名(no-such-function(1px))に not を付けたルールの中が使われました。
JavaScript で調べるときは CSS.supports()
JavaScript で対応しているかを調べるときは、CSS.supports() を使います。プロパティ名と値を別々に渡す書き方と、@supports の条件をそのまま文字列で渡す書き方があります。
CSS.supports('position-area', 'top'); // true
CSS.supports('(position-area: top)'); // true
CSS.supports('selector(:has(a))'); // true
検証環境では、上の3つはどれも true を返しました。ただし、@supports とは違うところがあります。
| 呼び方 | 結果 |
|---|---|
CSS.supports('display: grid')(かっこなし) |
true |
CSS.supports('display', 'grid !important') |
false |
CSS.supports('display', 'grid;') |
false |
CSS.supports(' display', 'grid')(先頭に空白) |
false |
条件を1つの文字列で渡すときは、かっこを省いても true になりました。@supports display: grid と書くとルールごと消えたので、CSS に書き写すときはかっこを付けます。2つの引数で呼ぶときは、値に !important やセミコロンを付けると false になりました。仕様にも、2つの引数の形では !important は値として読めず、プロパティ名の前後の空白も取り除かれないと書かれています。
対応しているブラウザー
@mdn/browser-compat-data 8.1.8 の互換性データでは、@supports と CSS.supports() は Chrome 28、Edge 12、Firefox 22、Safari 9 から使えます。条件に使う関数は、それぞれ次のバージョンからです。
| 条件 | Chrome・Edge | Firefox | Safari(macOS) | Safari(iOS) |
|---|---|---|---|---|
selector() |
83 | 69 | 14.1 | 14.5 |
font-format()・font-tech() |
108 | 106 | 17 | 17 |
at-rule() |
148 | 157 | Technology Preview のみ | なし |
前の節で触れた仕様の決まりでは、at-rule() のような関数を知らないブラウザーは、その条件を知らない関数の形として「偽」にします。@supports at-rule(@starting-style) と書くと、@starting-style そのものに対応していても、at-rule() を知らないブラウザーでは中が使われないことになります。新しい関数を条件にするときは、その関数自体の対応状況も確かめておきます。





