CSSのコンテナスタイルクエリで、変数の値ごとに見た目を変える方法

​​CSS​Playwright,カスタムプロパティ,コンテナクエリ

CSS の @container に style() を書くと、親要素のカスタムプロパティ(CSS 変数)の値を条件にして、中の要素のスタイルを切り替えられます。--status: error を書いたカードの中だけ、見出しの色や枠の色を変える、といった使い方です。クラス名を付け替えなくても、カスタムプロパティを1つ書き換えれば見た目がまとめて変わります。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、Chromium 153(ヘッドレス)です。ページを Playwright で開き、getComputedStyle() で計算値を調べました。Firefox と Safari では試していません。各ブラウザーの対応バージョンは、互換性データ(@mdn/browser-compat-data 8.1.8 と、GitHub 上の最新のデータ)の値です。対応していないブラウザーで、記号を使った @container が規則ごと読み飛ばされるかどうかは、古いブラウザーを検証環境で動かせなかったため確かめていません。

親のカスタムプロパティで、中の要素の見た目を変える

お知らせの枠を、--status の値で3種類に切り替える例です。

css
.alert {
  --status: info;
}

.alert-body {
  border-left: 6px solid #00c8e8;
  background: #eefafd;
  padding: 12px 16px;
}

.alert-title::before {
  content: "お知らせ:";
}

@container style(--status: warning) {
  .alert-body {
    border-left-color: #e0a000;
    background: #fff7e0;
  }
  .alert-title::before {
    content: "注意:";
  }
}

@container style(--status: error) {
  .alert-body {
    border-left-color: #d85878;
    background: #fdeef2;
  }
  .alert-title {
    color: #d85878;
  }
  .alert-title::before {
    content: "エラー:";
  }
}
html
<div class="alert" style="--status: error">
  <div class="alert-body">
    <div class="alert-title">送信できませんでした</div>
    …
  </div>
</div>

style(--status: error) は、「親の --status の計算値が error なら」という条件です。検証環境では、--status を書かない .alert、warning の .alert、error の .alert で、.alert-body の左の枠の色と背景色、見出しの前に付く文字が、それぞれ別のものになりました。

お知らせの枠を3つ縦に並べた画面。上は水色の枠で「お知らせ:メンテナンスの予定があります」、中は黄色の枠で「注意:保存されていない変更があります」、下はピンクの枠と文字で「エラー:送信できませんでした」
–status の値だけを変えた3つのお知らせ

コンテナの幅などで切り替えるサイズのクエリと違い、親に container-type を書く必要はありません。仕様では、すべての要素がスタイルクエリのコンテナになります(CSS Conditional Rules 5 のコンテナクエリの節)。

JavaScript で親のカスタムプロパティを書き換えたときも、その場で切り替わりました。style(--theme: dark) の条件で試したところ、親の要素に element.style.setProperty('--theme', 'dark') を実行すると当てはまるようになり、removeProperty('--theme') で元に戻りました。

値を書いた要素そのものは、条件で変えられない

@container style() が調べるのは、スタイルを当てたい要素の祖先です。カスタムプロパティを書いた要素そのものに、同じ条件でスタイルを当てることはできません。検証環境でも、<p style="--theme: dark"> に @container style(--theme: dark) { p { … } } を書いた場合は当てはまらず、--theme: dark を親の div に移すと当てはまりました。

上の例で .alert の中に .alert-body を1つ挟んでいるのはこのためです。外側の .alert に値を書き、枠や背景は内側の .alert-body に付けます。値を書いた要素そのものの見た目を変えたいときは、@container ではなく、CSS の if() の style() で値を切り替える方法もあります(互換性データでは Chrome 137 から対応し、Firefox と Safari は未対応です)。

どの祖先の値が使われるか

カスタムプロパティは子孫に継承されるので、値を書くのは親でなくてもかまいません。祖父母の section に --theme: dark を書くと、孫の p にも当てはまりました。

祖先の何段かに違う値が書いてあるときは、いちばん近い祖先の値が使われます。外側の section に --theme: dark、その中の div に --theme: light を書くと、div の中の p は style(--theme: dark) に当てはまりませんでした。外側の値で比べたいときは、外側の要素に container-name を付けて、@container の後に名前を書きます。

css
.card {
  container-name: card;
}

@container card style(--theme: dark) {
  /* .card の --theme が dark のときだけ */
}

この書き方では、間の div に --theme: light があっても当てはまりました。

@property で inherits: false にしたカスタムプロパティは、継承されません。検証環境では、inherits: false で、initial-value を off にして登録した --flag を使いました。--flag: on を親に書くと子は当てはまり、祖父母に書くと孫は当てはまりませんでした。孫の条件は、いちばん近い祖先である親の --flag で判定されます。親には祖父母の値が継承されないので、親の --flag は initial-value の off のままです(MDN の @property の inherits の説明)。

値の書き方で、当てはまらなくなる場合

style(--theme: dark) と書いたとき、検証環境で当てはまった値と、当てはまらなかった値は次のとおりです。

親に書いた値 結果
--theme: dark 当てはまる
--theme:dark(コロンの後に空白なし) 当てはまる
--theme: "dark"(引用符つき) 当てはまらない
--theme: Dark(大文字) 当てはまらない

@property で登録していないカスタムプロパティは、書いた文字のまま比べられます(MDN のガイドにある、未登録のカスタムプロパティの比べ方の説明)。そのため、親に --size: 1rem と書いても、style(--size: 16px) には当てはまりませんでした。@property で syntax: "<length>" を付けて登録した --len なら、--len: 1rem が style(--len: 16px) に当てはまりました。

また、比べられるのは今のところカスタムプロパティだけです。親の color が red でも、style(color: red) には当てはまりませんでした。MDN のガイドにある、通常のプロパティを調べる書き方の説明でも、カスタムプロパティ以外のプロパティを調べる書き方は、まだどのブラウザーも対応していないとされています。

値を書かない style(–theme) と、条件の組み合わせ

style(--theme) のように値を書かないと、「--theme に何かの値が入っているか」という条件になります。親に --theme: dark があれば当てはまり、どこにも --theme がなければ当てはまりませんでした。@property で登録したカスタムプロパティでは、initial-value と違う値のときだけ当てはまります(MDN のガイドの、値を書かない書き方の説明)。

and・or・not も使えます。

条件 親の値 結果
style(--a: 1) and style(--b: 2) --a: 1; --b: 2 当てはまる
style(--a: 1) and style(--b: 2) --a: 1 だけ 当てはまらない
style(--a: 1) or style(--b: 2) --b: 2 だけ 当てはまる
not style(--theme: dark) --theme なし 当てはまる

style((--a: 1) and (--b: 2)) のように、1つの style() の中で組み合わせる書き方も、両方の値があるときに当てはまりました。

数値の大小で比べる書き方

=、<、<=、>、>= を使うと、数値や長さの大小で比べられます。在庫の数 --stock が3以下なら「残りわずか」、0なら「売り切れ」と出す例です。

css
.item-body {
  border: 2px solid #00c8e8;
  padding: 12px 16px;
}

.badge {
  display: none;
}

@container style(--stock <= 3) {
  .badge {
    display: inline-block;
    background: #d85878;
    color: #fff;
  }
  .badge::before {
    content: "残りわずか";
  }
}

@container style(--stock = 0) {
  .item-body {
    border-color: #9aa5ab;
    color: #9aa5ab;
  }
  .badge {
    background: #9aa5ab;
  }
  .badge::before {
    content: "売り切れ";
  }
}

.item に style="--stock: 12"、"--stock: 3"、"--stock: 0" を書いて並べると、12 ではバッジが出ず(display: none)、3 では「残りわずか」、0 では「売り切れ」になり、枠も灰色になりました。0 は <= 3 にも当てはまるので、後に書いた = 0 のルールで、バッジの背景色と ::before の文言(「売り切れ」)を上書きしています。

商品の枠を3つ縦に並べた画面。在庫12の「猫の手ミトン」はバッジなし、在庫3の「肉球クッション」にはピンクの「残りわずか」、在庫0の「しっぽ型しおり」は枠と文字が灰色になり、灰色の「売り切れ」が付いている
–stock の数で、バッジと枠の色が変わる

ほかにも、次のような書き方を試しました。

条件 親の値 結果
style(--n > 3) --n: 3 当てはまらない
style(2 < --n <= 5) --n: 5 当てはまる
style(3 < --n) --n: 5 当てはまる
style(var(--n) > 3) --n: 5 当てはまる
style(--n > --m) --n: 5; --m: 2 当てはまる
style(--w >= 600px) --w: 40rem 当てはまる
style(--w > 5) --w: 10px 当てはまらない

2 < --n <= 5 のように、範囲の両端を1つの条件で書けます。40rem と 600px のように単位が違っても、長さどうしなら比べられました。一方、長さの 10px と、単位のない数の 5 は比べられませんでした。仕様では、両側の値の種類が同じでないときは偽になると決められています。ただし単位のない 0 は例外で、長さと比べるときは長さの 0 として扱われます(CSS Conditional Rules 5 のスタイルクエリの節)。検証環境でも、--w: 0 は style(--w = 0px) に当てはまりました。

コロンで書くか、記号で書くか

style(--n: 3) と style(--n = 3) は似ていますが、比べ方が違います。コロンの書き方は、書いた値どうしを文字のまま比べます。記号の書き方は、両側を数値や長さとして計算してから比べます(MDN のガイドの、2つの書き方の違いの説明)。検証環境での結果です。

親の値 コロンで書いた条件 結果 記号で書いた条件 結果
--n: calc(6/2) style(--n: 3) 当てはまらない style(--n = 3) 当てはまる
--n: 3.0 style(--n: 3) 当てはまらない style(--n = 3) 当てはまる
--gap: 16px style(--gap: 1rem) 当てはまらない style(--gap = 1rem) 当てはまる
--s: new style(--s: new) 当てはまる style(--s = new) 当てはまらない
ポイント

warning や dark のような言葉で比べるときはコロン、数や長さで比べるときは = や <= を使います。言葉を = で比べると、数値として読めないので当てはまりません。

コロンの書き方では、左側にカスタムプロパティの名前をそのまま書きます。style(var(--n): 3) と書いた @container は、検証環境では規則ごと読み込まれませんでした。

ブラウザーの対応

互換性データに載っている、カスタムプロパティの値を調べるスタイルクエリ(style_queries_for_custom_properties)の対応バージョンは次のとおりです。

ブラウザー 対応したバージョン
Chrome(Android 版を含む)、Edge 111
Firefox(Android を含む) 151
Safari(iOS を含む) 18

記号(=、<、<= など)で比べる書き方だけを分けた項目は、互換性データ 8.1.8 にはありません。npm でまだ公開されていない、GitHub 上の最新の互換性データ(2026年11月9日時点)には range_syntax という項目が加わっていて、対応バージョンは次のとおりです。

ブラウザー 記号で比べる書き方に対応したバージョン
Chrome(Android 版を含む)、Edge 142
Firefox(Android を含む) 151
Safari(iOS を含む) 未対応

ブラウザーの機能ごとの対応状況をまとめた web-features のデータでは、記号で比べる書き方は、主要なブラウザーのすべてで使える状態(Baseline)にはなっていません。

Firefox は、互換性データでは 151 から対応となっていますが、MDN の Firefox 151 の開発者向けリリースノートでは、この書き方は既定では無効の実験的な機能として載っていて、layout.css.attr.enabled を有効にすると使えるとされています。

​Posted by 86