CSSのコンテナスタイルクエリで、変数の値ごとに見た目を変える方法
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種類に切り替える例です。
.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: "エラー:";
}
}
<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 の左の枠の色と背景色、見出しの前に付く文字が、それぞれ別のものになりました。

コンテナの幅などで切り替えるサイズのクエリと違い、親に 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 の後に名前を書きます。
.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なら「売り切れ」と出す例です。
.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 の文言(「売り切れ」)を上書きしています。

ほかにも、次のような書き方を試しました。
| 条件 | 親の値 | 結果 |
|---|---|---|
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 を有効にすると使えるとされています。





