このページは Cloud Translation API によって翻訳されました。

スタイルクエリスタートガイド

Una Kravets

親の行内サイズとコンテナのクエリ単位の値をクエリする機能は、最近、すべての最新のブラウザエンジンで安定的にサポートされるようになりました。

対応ブラウザ

ソース

ただし、制限付きクエリの仕様には、サイズのクエリだけでなく、親のスタイル値のクエリも含まれています。Chromium 111 以降では、カスタムプロパティ値にスタイル封じ込めを適用し、カスタムプロパティの値を親要素に照会できます。

対応ブラウザ

ソース

つまり、CSS でスタイルをより論理的に制御できるようになり、アプリケーションのロジックレイヤとデータレイヤをスタイルからより適切に分離できるようになります。

サイズとスタイルのクエリを対象とする CSS Containment モジュールレベル 3 仕様では、font-weight: 800 などのプロパティと値のペアを含む、任意のスタイルを親からクエリできます。ただし、この機能のリリースに伴い、現在のところ、スタイルクエリは CSS カスタムプロパティ値でのみ機能します。これは、スタイルを組み合わせたり、データとデザインを分離したりする場合に非常に便利です。CSS カスタムプロパティでスタイルクエリを使用する方法を見ていきましょう。

スタイルクエリを使ってみる

次のような HTML があるとします。

<ul class="card-list">
  <li class="card-container">
    <div class="card">
      ...
    </div>
  </li>
</ul>

スタイルクエリを使用するには、まずコンテナ要素を設定する必要があります。直接親と間接親のどちらをクエリするかによって、アプローチが若干異なります。

直接の親へのクエリ

スタイルクエリの図。

スタイルクエリとは異なり、.card が直接親のスタイルをクエリできるようにするために、container-type プロパティまたは container プロパティを使用して .card-container に制限を適用する必要はありません。ただし、スタイル（この場合はカスタムプロパティ値）は、コンテナ（この場合は .card-container）または DOM でスタイル設定する要素を含む要素に適用する必要があります。クエリでスタイル設定している直接要素に、そのクエリを使用してスタイル設定することはできません。無限ループが発生する可能性があるためです。

親を直接クエリするには、次のように記述します。

/* styling .card based on the value of --theme on .card-container */
@container style(--theme: warm) {
  .card {
    background-color: wheat;
    border-color: brown; 
    ...
  }
}

スタイルクエリでは、クエリが style() でラップされていることに気付いたかもしれません。これは、スタイルのサイズ値との混同を避けるためです。たとえば、コンテナの幅のクエリは @container (min-width: 200px) { … } として記述できます。親コンテナの幅が 200 ピクセル以上であれば、スタイルが適用されます。ただし、min-width は CSS プロパティにもなり、スタイルクエリを使用して min-width の CSS 値をクエリできます。そのため、違いを明確にするために style() ラッパーを使用します。@container style(min-width: 200px) { … }

直接親以外のスタイル設定

直接の親ではない要素のスタイルをクエリする場合は、その要素に container-name を指定する必要があります。たとえば、.card-list のスタイルに基づいて .card にスタイルを適用するには、.card-list に container-name を指定してスタイルクエリで参照します。

/* styling .card based on the value of --moreGlobalVar on .card-list */
@container cards style(--moreGlobalVar: value) {
  .card {
    ...
  }
}

一般に、クエリ対象を明確にして、コンテナに簡単にアクセスできるように、コンテナに名前を付けることをおすすめします。たとえば、.card 内の要素に直接スタイルを適用する場合に便利です。.card-container に名前付きコンテナがないと、直接クエリを実行できません。

しかし、これらはすべて、実際にやってみるともっと理にかなっています。いくつか例を見てみましょう。

スタイルクエリの実例

複数の商品カードが並んだデモ画像。一部の商品カードには「新品」または「在庫切れ」のタグが付いています。在庫切れの商品カードの背景は赤色です。

スタイルクエリは、複数のバリエーションがある再利用可能なコンポーネントがある場合や、すべてのスタイルを制御できないが、特定のケースで変更を適用する必要がある場合に特に便利です。この例は、同じカードコンポーネントを共有する商品カードのセットを表示しています。商品カードによっては、--detail という名前のカスタムプロパティによって、「新品」や「在庫切れ」などの追加の詳細やメモが表示されます。また、商品の在庫が少ない場合は、背景に濃い赤色の枠線が表示されます。このタイプの情報はサーバー側でレンダリングされる可能性があり、次のようにインラインスタイルを使用してカードに適用できます。

 <div class="product-list">
  <div class="product-card-container" style="--detail: new">
    <div class="product-card">
      <div class="media">
        <img .../>
      <div class="comment-block"></div>
    </div>
  </div>
  <div class="meta">
    ...
  </div>
  </div>
  <div class="product-card-container" style="--detail: low-stock">
    ...
  </div>
  <div class="product-card-container">
    ...
  </div>
  ...
</div>

この構造化データを基に、--detail に値を渡し、この CSS カスタムプロパティを使用してスタイルを適用できます。

@container style(--detail: new) {
  .comment-block {
    display: block;
  }
  
  .comment-block::after {
    content: 'New';
    border: 1px solid currentColor;
    background: white;
    ...
  }
}

@container style(--detail: low-stock) {
  .comment-block {
    display: block;
  }
  
  .comment-block::after {
    content: 'Low Stock';
    border: 1px solid currentColor;
    background: white;
    ...
  }
  
  .media-img {
    border: 2px solid brickred;
  }
}

上記のコードでは、--detail: low-stock と --detail: new にチップを適用できますが、コードブロックに冗長性があることに気づいたかもしれません。現在のところ、@container style(--detail) で --detail の存在のみをクエリする方法はありません。これにより、スタイルをより適切に共有し、重複を減らすことができます。この機能は現在、ワーキンググループで議論中です。

天気情報カード

上の例では、複数の値が可能な単一のカスタムプロパティを使用してスタイルを適用しました。ただし、複数のカスタムプロパティを使用してクエリを実行することで、組み合わせて使用することもできます。天気カードの例を以下に示します。

天気情報カードのデモ。

これらのカードの背景のグラデーションやアイコンのスタイルを設定するには、「曇り」、「雨」、「晴れ」などの天候の特性を探します。

@container style(--sunny: true) {
  .weather-card {
    background: linear-gradient(-30deg, yellow, orange);
  }
  
  .weather-card:after {
    content: url(<data-uri-for-demo-brevity>);
    background: gold;
  }
}

このようにして、各カードの固有の特性に基づいてスタイルを設定できます。また、メディアクエリの場合と同様に、and コンビネーターを使用して、特性（カスタムプロパティ）の組み合わせにスタイルを適用することもできます。たとえば、曇りと晴れの両方の日の場合は、次のように記述します。

@container style(--sunny: true) and style(--cloudy: true) {
    .weather-card {
      background: linear-gradient(24deg, pink, violet);
    }
  
  .weather-card:after {
      content: url(<data-uri-for-demo-brevity>);
      background: violet;
  }
}

注: スタイルコンテナのクエリでさらに便利なのは、範囲値をクエリできることです。たとえば、--chanceOfRain: 50% などのデータを送信し、@container style(30% <= --chanceOfRain < 60%) などの範囲を使用してスタイルを適用できます。これにより、デザインとそのさまざまな組み合わせをよりきめ細かく指定できます。これは、コンテナクエリのワーキンググループで積極的に議論されているもう 1 つの機能です。

設計からデータを分離する

どちらのデモでも、データレイヤー（ページにレンダリングされる DOM）を適用されたスタイルから分離することで、構造的なメリットが得られます。スタイルは、コンポーネントスタイル内に存在する可能性のあるバリエーションとして記述されます。一方、エンドポイントは、コンポーネントのスタイル設定に使用するデータを送信できます。最初のケースのように --detail 値を更新する単一の値を使用することも、2 番目のケースのように複数の変数（--rainy、--cloudy、--sunny のいずれかを設定）を使用することもできます。これらの値を組み合わせることもできます。--sunny と --cloudy の両方をチェックすると、部分的に曇りのスタイルを表示できます。

JavaScript によるカスタムプロパティ値の更新は、DOM モデルのセットアップ時（フレームワーク内のコンポーネントの構築時）でも、いつでも <parentElem>.style.setProperty('--myProperty’, <value>) を使用して更新できます。I

以下は、数行のコードを記述してボタンの --theme を更新し、スタイルクエリとそのカスタムプロパティ（--theme）を使用してスタイルを適用するデモです。

スタイルクエリを使用してカードのスタイルを設定する。カスタムプロパティ値の更新に使用される JavaScript は次のとおりです。

const themePicker = document.querySelector('#theme-picker')
const btnParent = document.querySelector('.btn-section');

themePicker.addEventListener('input', (e) => {
  btnParent.style.setProperty('--theme', e.target.value);
})

この記事で説明した機能はほんの一部です。コンテナクエリでは、動的でレスポンシブなインターフェースの構築に役立つ多くの要素が想定されています。特にスタイルクエリについては、未解決の問題がいくつか残っています。1 つは、カスタムプロパティ以外の CSS スタイルのスタイルクエリの実装です。これは現在の仕様レベルにすでに含まれていますが、まだどのブラウザにも実装されていません。ブール値コンテキスト評価は、未解決の問題が解決された時点で現在の仕様レベルに追加される予定です。範囲クエリは、仕様の次のレベルで予定されています。

スタイルクエリ スタートガイド