本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2026年5月26日(火)更新: 2026年11月9日(月)約10分で読めます

Container style queriesでCSS変数で条件分岐

Container style queriesは、@container style(--theme: dark)のように、祖先のCSS変数の値を条件にスタイルを切り替える仕組みです。テーマやサイズを親の変数1つで子に伝えられます。

Newly availableContainer style queries2026年〜
  • 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で祖先に名前を付けて決めます。

css
.theme {
  container-name: theme;
スタイルクエリで見る祖先に名前を付ける
  --theme: dark;
}

@container theme style(--theme: dark) {
theme と名前を付けた祖先の --theme が dark のときだけ当たる
  .card {
    background: black;
    color: white;
  }
}

.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のパディングを切り替える例です。

css
.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で見る祖先を決めておけば、その上書きに左右されません。

css
.theme {
  container-name: theme;
}

@container theme style(--theme: dark) {
  .card {
    background: black;
    color: white;
  }
}

@container themeはcontainer-name: themeの付いた祖先を見るので、articleが--theme: lightに上書きしていても、sectionのdarkで判定されます。.cardにはdark側のスタイルが当たります。

container-nameを付けずに@container style(--theme: dark)と書くと、スタイルを当てる要素の親を見ます。どの要素もクエリで見る対象になれるので、いちばん近い祖先である親が選ばれるからです。上の例ではarticleの--theme: lightが見えて、.cardにはdark側が当たりません。テーマのように上から渡す値は、名前を付けて見る祖先を決めておくと、途中の上書きに左右されません。

css
.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;
}
結果

親をdark、途中の要素をlightにすると、名前を付けたクエリのカードは親のdarkで、名前を付けないクエリのカードは途中の要素のlightで描かれます。

おわりに

Container style queriesを使うと、祖先に置いたカスタムプロパティの値を条件にして、子孫のスタイルを切り替えられます。どの祖先の値を見るかはcontainer-nameで決め、値はスタイルを当てる要素の祖先に置きます。