Container style queriesでCSS変数で条件分岐
Container style queriesは、@container style(--theme: dark)のように、祖先のCSS変数の値を条件にスタイルを切り替える仕組みです。テーマやサイズを親の変数1つで子に伝えられます。
- Chrome111
- Edge111
- Firefox151
- Safari18
はじめに
Container style queriesは、@container style(--theme: dark)のように、祖先要素のカスタムプロパティ(CSS変数)の値を条件にして、子孫のスタイルを切り替えるCSSの仕組みです。サイズクエリの@container (width > 600px)と同じ@containerルールで、幅の代わりにカスタムプロパティの値を見ます。
親のクラスで子のスタイルを変えるときは、.theme-dark .cardのような子孫セレクタを使います。ただ、セレクタはカスタムプロパティの値を見られないので、style属性で書いた値や親から継承した値を条件にできません。Container style queriesを使うと、親はカスタムプロパティを置くだけで、子のCSSがその値を読んでスタイルを決められます。Firefox 151が対応して、Baseline 2026に入りました。
基本構文
@containerのstyle(...)に、カスタムプロパティと値を書きます。どの祖先の値を見るかは、container-nameで祖先に名前を付けて決めます。
.theme {
container-name: theme;
スタイルクエリで見る祖先に名前を付ける
--theme: dark;
}
@container theme style(--theme: dark) {
theme と名前を付けた祖先の --theme が dark のときだけ当たる
.card {
background: black;
color: white;
}
}<div class="theme">
<p class="card">カード</p>
</div>.themeの中の.cardは、背景が黒、文字が白になります。.themeの--themeをlightに書き換えると、元の色に戻ります。
サイズクエリと違って、container-typeの指定は要りません。スタイルクエリでは、どの要素もクエリで見る対象になれるからです。
ただし、クエリが見るのは祖先だけです。.card自身に--theme: darkを書いて@container style(--theme: dark)で.cardを指定しても、スタイルは当たりません。値は、スタイルを当てたい要素の祖先に置きます。style(color: black)のように、カスタムプロパティではないふつうのプロパティを書いた条件も、どのブラウザでもマッチしません。
@container theme { ... }のようにstyle()を書かない形は、名前だけで祖先を探す別の機能で、カスタムプロパティの値は見ません。この形は@containerの名前だけで親要素に応じてスタイルを変えるで書いています。
親の値でボタンの大きさを変える
.surfaceに置いた--sizeの値に応じて、子孫の.buttonのパディングを切り替える例です。
.surface {
container-name: surface;
--size: md;
}
@container surface style(--size: md) {
.button {
padding: 8px 16px;
}
}
@container surface style(--size: sm) {
.button {
padding: 4px 8px;
}
}ボタンに大きさ用のクラスを足さなくても、親の--sizeを切り替えるだけで、中のボタンがまとめて変わります。
値は、前後の空白を除いた文字列として比べられます。--size:mdと空白なしで書いてもstyle(--size: md)にマッチしますが、--gap: 16pxはstyle(--gap: 1rem)にマッチしません。@propertyでsyntax: '<length>'を登録したカスタムプロパティなら、長さとして比べられ、16pxが1remにマッチします。
名前で見る祖先を決める
カスタムプロパティは継承されるので、深い子孫にも上の祖先の値が届きます。途中の要素が同じカスタムプロパティを上書きしていても、container-nameで見る祖先を決めておけば、その上書きに左右されません。
.theme {
container-name: theme;
}
@container theme style(--theme: dark) {
.card {
background: black;
color: white;
}
}<section class="theme" style="--theme: dark">
<article style="--theme: light">
<p class="card">深い場所のカード</p>
</article>
</section>@container themeはcontainer-name: themeの付いた祖先を見るので、articleが--theme: lightに上書きしていても、sectionのdarkで判定されます。.cardにはdark側のスタイルが当たります。
container-nameを付けずに@container style(--theme: dark)と書くと、スタイルを当てる要素の親を見ます。どの要素もクエリで見る対象になれるので、いちばん近い祖先である親が選ばれるからです。上の例ではarticleの--theme: lightが見えて、.cardにはdark側が当たりません。テーマのように上から渡す値は、名前を付けて見る祖先を決めておくと、途中の上書きに左右されません。
.theme {
container-name: theme;
}
.card {
padding: 0.5rem;
border: 1px solid gray;
background: white;
color: black;
}
@container theme style(--theme: dark) {
.named {
background: black;
color: white;
}
}
@container style(--theme: dark) {
.unnamed {
background: black;
color: white;
}
}
label {
display: block;
}<label>
親の--theme
<select id="parent">
<option>light</option>
<option selected>dark</option>
</select>
</label>
<label>
途中の要素の--theme
<select id="middle">
<option value="">上書きしない</option>
<option selected>light</option>
<option>dark</option>
</select>
</label>
<section class="theme" style="--theme: dark">
<article style="--theme: light">
<p class="card named">名前を付けたクエリ</p>
<p class="card unnamed">名前を付けないクエリ</p>
</article>
</section>const section = document.querySelector('.theme');
const article = document.querySelector('article');
document.querySelector('#parent').addEventListener('change', (event) => {
section.style.setProperty('--theme', event.target.value);
});
document.querySelector('#middle').addEventListener('change', (event) => {
// 空の文字列を渡すと、--theme の宣言が消える
article.style.setProperty('--theme', event.target.value);
});親をdark、途中の要素をlightにすると、名前を付けたクエリのカードは親のdarkで、名前を付けないクエリのカードは途中の要素のlightで描かれます。
おわりに
Container style queriesを使うと、祖先に置いたカスタムプロパティの値を条件にして、子孫のスタイルを切り替えられます。どの祖先の値を見るかはcontainer-nameで決め、値はスタイルを当てる要素の祖先に置きます。