CSSの@supportsで、未対応のブラウザー向けの指定を分ける方法

​​CSS​JavaScript,Playwright,アンカー配置

新しい 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つ目に新しい値を書きます。

css
.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(アンカー配置)が使えるブラウザーではボタンの上に、使えないブラウザーではボタンの下に出します。

html
<div class="demo">
  <button class="help-btn" type="button">?</button>
  <p class="tip">保存すると、下書きは消えます</p>
</div>
css
/* 代わりの指定(どのブラウザーでも使われる) */
.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 だけを条件にしました。

3つの画面を縦に並べた比較。1つ目は position-area に対応している場合で、「保存すると、下書きは消えます」というヒントが「?」ボタンの上に出ている。2つ目は対応していないブラウザーで @supports で分けた場合で、ヒントがボタンの下に出ている。3つ目は対応していないブラウザーで @supports で分けなかった場合を 48px スクロールした画面で、ボタンは上に動いたのに、ヒントはボタンから離れた位置に残っている
ヒントの出方の比較。対応していない状態は、@supports の条件やプロパティ名を存在しないものに変えて再現した

検証環境でボタンとヒントの位置を測った結果は次のとおりです。ボタンは、ページの上端から 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 の条件をそのまま文字列で渡す書き方があります。

js
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() を知らないブラウザーでは中が使われないことになります。新しい関数を条件にするときは、その関数自体の対応状況も確かめておきます。

​Posted by 86