:has()セレクター

問題

CSSには、子要素に基づいて親要素を選択する方法がありませんでした。開発者は、入力が無効な場合にフォームグループをハイライトしたり、画像の有無に基づいてカードレイアウトを変更したりするなど、親子の状態関係にJavaScriptでクラスをトグルすることに頼っていました。AIエージェントが:has()を使うことはほとんどなく、代わりにこれらのパターンにJavaScriptベースのソリューションを提案します。

解決方法

:has()関係擬似クラスは、指定されたセレクターリストに一致する要素を少なくとも1つ含む要素を選択します。「親セレクター」として機能しますが、はるかに強力です：子、兄弟、子孫など、あらゆる相対的な位置を見て条件的にスタイルを適用できます。

コード例

基本的な親の選択

/* Style a card differently when it contains an image */
.card:has(img) {
  grid-template-rows: 200px 1fr;
}

.card:has(img) .card-body {
  padding-top: 0;
}

フォームバリデーションのスタイリング

JavaScriptなしで入力の有効性に基づいてフォームグループにスタイルを適用します。

/* Highlight the entire field group when input is invalid */
.field-group:has(:user-invalid) {
  border-left: 3px solid red;
  background: #fff5f5;
}

.field-group:has(:user-invalid) .error-message {
  display: block;
}

/* Style label when its sibling input is focused */
.field-group:has(input:focus) label {
  color: blue;
  font-weight: bold;
}

<div class="field-group">
  <label for="email">Email</label>
  <input type="email" id="email" required />
  <span class="error-message">Please enter a valid email</span>
</div>

数量クエリ

JavaScriptなしで子要素の数に基づいてレイアウトを適応させます。

/* Switch to grid layout when a list has 5 or more items */
.item-list:has(> :nth-child(5)) {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
}

/* Single-column layout for fewer items */
.item-list:not(:has(> :nth-child(5))) {
  display: flex;
  flex-direction: column;
}

/* Style based on even/odd number of children */
.grid:has(> :last-child:nth-child(even)) {
  /* Even number of children */
  grid-template-columns: repeat(2, 1fr);
}

.grid:has(> :last-child:nth-child(odd)) {
  /* Odd number of children */
  grid-template-columns: repeat(3, 1fr);
}

兄弟の状態に基づくスタイリング

/* Change page layout when a sidebar checkbox is checked */
body:has(#sidebar-toggle:checked) .main-content {
  margin-left: 0;
}

body:has(#sidebar-toggle:checked) .sidebar {
  transform: translateX(-100%);
}

他のセレクターとの組み合わせ

/* Style a navigation item that contains the current page link */
nav li:has(> a[aria-current="page"]) {
  background: #e0e7ff;
  border-radius: 4px;
}

/* Style a table row that has an empty cell */
tr:has(td:empty) {
  opacity: 0.6;
}

:has()と直接子結合子の使用

パフォーマンス向上のために直接子結合子>を使用しましょう。ブラウザの検索をすべての子孫ではなく直接の子要素に限定します。

/* Preferred: direct child (faster) */
.container:has(> .alert) {
  border: 2px solid red;
}

/* Avoid when possible: descendant (slower on large DOMs) */
.container:has(.alert) {
  border: 2px solid red;
}

落とし穴：無関係な構造にゲートされたレイアウト

:has()を使うと、任意の要素の有無を条件にどんなルールでも簡単にゲートできます。しかし、無条件に適用されるべきレイアウトルール — レスポンシブなスタッキング、最小サイズのリセット、オーバーフロー対策 — にこれを適用すると、ゲート対象の要素が存在しないページだけが壊れます。

失敗パターン

/* BROKEN: base layout gated on an unrelated element's presence */
@media (max-width: 1023px) {
  .shell:has(#code-panel) {
    flex-direction: column;
  }
  .shell:has(#code-panel) .sidebar {
    width: 100%;
  }
}

意図は「狭いビューポートではシェルを縦に積む」でした。:has(#code-panel)のゲートは、その意図を無関係な条件 — そのページがたまたまコードパネルを含むかどうか — に結び付けてしまいます。パネルを持たないページ（インデックスページや設定ページ）は狭いビューポートでも横並びのままになり、縮まないサイドバーがメインコンテンツを画面外に押し出します。パネルを持つページはすべて正しく表示されるため、このバグは静かにリリースされてしまいます。

修正方法

無条件であるべきレイアウトは無条件のままにします。ゲートするのは、その機能が導入する差分だけです：

@media (max-width: 1023px) {
  /* Unconditional: every page stacks */
  .shell {
    flex-direction: column;
  }
  .shell .sidebar {
    width: 100%;
  }

  /* The panel's own delta needs no gate — this selector
     already matches only when the panel exists */
  .code-panel {
    max-height: 40vh;
    overflow-y: auto;
  }

  /* Gate only deltas on OTHER elements that genuinely
     depend on the panel's presence */
  .shell:has(#code-panel) .sidebar {
    max-height: 120px;
    overflow-y: auto;
  }
}

スタッキングはすべてのページに適用されるようになりました。パネル自身への差分にはゲートは不要です — .code-panelはパネルが存在するときにしかマッチしません。:has()のゲートが残るのは、パネルの存在に本当に依存する、他の要素への差分だけです。

危険信号

他の要素 — サイドバーやメインカラム — をスタイリングする:has(#feature)のゲートは精査に値します。ただし、セレクターの形そのものが問題なのではありません。上記の例にある.card:has(img) .card-bodyは他の要素をスタイリングしていますが正しい使い方です — その差分は画像が存在するときにだけ意味を持つからです。判断基準は、その機能が存在しなくてもその宣言が必要かどうかです。レスポンシブなスタッキング、最小サイズのリセット、オーバーフロー対策はすべてのページで成立しなければなりません — ゲートされた宣言がこのテストに該当するなら、ゲートを外してください。

レビューをすり抜ける理由

開発中に作者もレビュアーも、たまたまその機能を含むページばかりを開くため、ゲートされたルールは確認するすべての画面で発火します。壊れているのは、誰も狭いビューポートで再確認しない、機能を持たないページだけです。レイアウトコードに:has()のゲートが現れたときは、必ず機能が存在しないバリアントを明示的にテストしてください。

ブラウザサポート

• Chrome 105+

• Safari 15.4+

• Firefox 121+

• Edge 105+

グローバルサポートは96%を超えています。機能検出は@supports selector(:has(*))で利用可能です。

AIがよくやるミス

• :has()で解決できる問題にJavaScriptのクラストグルを提案する

• :has()の存在を知らず回避策を推奨する

• :has()内で直接子>の方がパフォーマンスが良い場合に子孫セレクターを使用する

• :has()と:not()を逆ロジックのために組み合わせない（例：.card:not(:has(img))）

• :has()が子孫だけでなく兄弟も見ることができることを忘れる（例：h2:has(+ p)）

• :has()のポリフィルを試みる — リアルタイムのDOM認識が必要で、効率的なポリフィルはできない

• 無条件に適用すべきレイアウトルール（レスポンシブなスタッキング、サイズのリセット）を無関係な要素の有無でゲートする — 上記「落とし穴：無関係な構造にゲートされたレイアウト」を参照

使い分け

• 子の状態に基づく親のスタイリング（フォームバリデーション、コンテンツ対応レイアウト）

• 子要素の数に基づいてレイアウトを適応させる数量クエリ

• JavaScriptなしの状態駆動スタイリング（チェックボックスハック、フォーカス管理）

• コンテンツの有無に基づく条件的なコンポーネントスタイリング

ライブプレビュー

参考リンク

• :has() - MDN

• :has() CSS relational pseudo-class - Can I Use

• CSS :has() Parent Selector - Ahmad Shadeed

• The CSS :has Selector - CSS-Tricks

• Quantity Queries with CSS :has() - Frontend Masters