本文へ移動

k8o

お問い合わせ

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

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

Blog

公開: 2025年12月20日(土)更新: 2026年11月9日(月)約17分で読めます

@scopeでCSSのスタイルを特定の要素の中だけに効かせる

@scopeは、CSSのスタイルが効く範囲をある要素の中に限るアットルールです。BEMやCSS Modulesを使わずにコンポーネントの中だけにスタイルを当てる書き方と、内側に下限を設けるドーナツスコープ、近接性を説明します。

Newly available@scope2026年〜
  • Chrome143
  • Edge143
  • Firefox146
  • Safari26.4

はじめに

@scopeは、CSSのスタイルが当たる範囲を、ある要素(スコープルート)の中に限るアットルールです。@scope (.card) { h2 { ... } }と書くと、.cardの中のh2にだけスタイルが当たります。Safari 26.4が対応して、Baseline 2026に入りました。

要素の中だけにスタイルを当てるのは、子孫セレクタの.card h2でもできます。クラス名の衝突は、BEMやCSS Modulesでも避けられます。@scopeでしかできないのは、内側に下限を設けて入れ子の部分を外すことと、詳細度が同じときに近いスコープのスタイルを勝たせることです。クラス名を付けずに、<style>要素の親の中だけにスタイルを当てることもできます。

基本的な構文

@scopeは、スタイルシートにも<style>要素の中にも書けます。

スタイルシート形式

スタイルシートに書くときは、@scopeの後の括弧にスコープルートのセレクタを書きます。

css
@scope (.card) {
  /* .card内のh2要素にのみ適用 */
  h2 {
    color: var(--color-primary);
  }
  /* .card内のp要素にのみ適用 */
  p {
    color: var(--color-text);
  }
}

インライン形式

<style>要素の中に括弧を付けずに@scopeと書くと、<style>要素の親要素がスコープルートになります。

html
<div class="card">
  <style>
    @scope {
      /* .card内のh2要素にのみ適用 */
      h2 {
        color: red;
      }
    }
  </style>
  <h2>カードのタイトル</h2>
</div>
<h2>カードの外のタイトル</h2>

開くと、カードのタイトルだけが赤くなり、カードの外のタイトルは黒のままです。

ドーナツスコープ

toの後にセレクタを書くと、スコープに下限(スコープリミット)を設けられます。スコープルートからスコープリミットの手前までの、穴の開いた範囲にだけスタイルが当たるので、ドーナツスコープと呼ばれます。

css
@scope (.article) to (.nested-content) {
  img {
    border: 2px solid var(--color-border);
    border-radius: var(--radius-md);
  }
}

次のHTMLでは、.articleの中の<img>にスタイルが当たり、.nested-contentの中の<img>には当たりません。

html
<label><input type="checkbox" id="scoped" checked /> @scopeを使う</label>
<div class="container">
  <article class="article">
    <p>この記事の内容</p>
    <!-- スタイルが反映される -->
    <img src="/icon.png" alt="記事の画像1" width="64" height="64" />
    <div class="nested-content">
      <p>ネストされたコンテンツ</p>
      <!-- スタイルが反映されない -->
      <img src="/icon.png" alt="記事の画像2" width="64" height="64" />
    </div>
  </article>
  <!-- スタイルが反映されない -->
  <img src="/icon.png" alt="記事の画像3" width="64" height="64" />
</div>
結果

結果の欄でチェックを外して.article imgに切り替えると、.nested-contentの中の画像にもボーダーが付きます。

:scope疑似クラス

@scopeの中でスコープルート自身にスタイルを当てるときは、:scope疑似クラスを使います。

css
@scope (.card) {
  :scope {
    background: var(--color-bg-subtle);
    padding: var(--spacing-lg);
    border-radius: var(--radius-lg);
  }

  h3 {
    margin-bottom: var(--spacing-sm);
  }
}

:scopeは、スコープリミットのセレクタにも書けます。to (:scope > .nested-content)と書くと、スコープルートの直接の子の.nested-contentだけが下限になります。

css
@scope (.article) to (:scope > .nested-content) {
  img {
    border: 2px solid var(--color-border);
    border-radius: var(--radius-md);
  }
}
html
<label><input type="checkbox" id="child" checked /> :scope &gt; を付ける</label>
<div class="container">
  <article class="article">
    <p>この記事の内容</p>
    <!-- スタイルが反映される -->
    <img src="/icon.png" alt="記事の画像1" width="64" height="64" />
    <div class="nested-content">
      <p>ネストされたコンテンツ</p>
      <!-- スタイルが反映されない -->
      <img src="/icon.png" alt="記事の画像2" width="64" height="64" />
    </div>
    <div>
      <div class="nested-content">
        <p>ネストされたコンテンツ</p>
        <!-- スタイルが反映される -->
        <img src="/icon.png" alt="記事の画像2" width="64" height="64" />
      </div>
    </div>
  </article>
  <!-- スタイルが反映されない -->
  <img src="/icon.png" alt="記事の画像3" width="64" height="64" />
</div>
結果

1つ目の.nested-contentは.articleの直接の子なので、中の<img>にはスタイルが当たりません。2つ目は<div>を挟んだ孫なので下限にならず、中の<img>にもスタイルが当たります。

結果の欄でチェックを外して下限をto (.nested-content)に切り替えると、孫の.nested-contentの中の画像からもボーダーが消えます。

スコープの近接性

@scopeで、カスケードにスコープの近接性という基準が加わりました。詳細度が同じスタイルがぶつかったときは、要素からスコープルートまでの階層が少ないほうのスタイルが勝ちます。

css
@scope (.info-box) {
  .message {
    color: var(--color-fg-info);
    background-color: var(--color-bg-info);
  }
}

@scope (.warning-box) {
  .message {
    color: var(--color-fg-warning);
    background-color: var(--color-bg-warning);
  }
}
html
<label><input type="checkbox" id="scoped" checked /> @scopeを使う</label>
<div class="info-box">
  <p class="message">情報メッセージ</p>
  <div class="warning-box">
    <p class="message">警告メッセージ</p>
    <div class="info-box">
      <p class="message">ネストされた情報メッセージ</p>
    </div>
  </div>
</div>
結果

いちばん内側の.messageは、.warning-boxより.info-boxのほうが近いので、.info-boxのスタイルになります。@scopeを使わずに.info-box .messageと.warning-box .messageで書くと、詳細度が同じなので、後に書いた.warning-boxのスタイルになります。

結果の欄でチェックを外して@scopeを使わない書き方に切り替えると、いちばん内側のメッセージが警告の色に変わります。

近接性が効くのは、詳細度が同じときだけです。@scopeの中のh2の詳細度はh2の分だけで、スコープルートの.cardは足されません。

css
.card h2 {
  color: blue;
}

@scope (.card) {
  h2 {
    color: red; /* 後に書いても、詳細度の高い.card h2の青が勝つ */
  }
}

.cardの中のh2は青になります。@scopeの中を:scope h2と書くと、:scopeの分だけ詳細度が上がって.card h2と同じになり、近接性で赤が勝ちます。2つの規則を書く順を入れ替えても赤のままです。

@scopeの注意点

スタイルの継承は制限されない

@scopeが限るのはセレクタが当たる範囲で、CSSの継承は止めません。Shadow DOMのようにスタイルを閉じ込めるのではなく、スタイルが当たる要素を絞るだけです。

css
@scope (.container) to (.nested) {
  :scope {
    color: red;
  }
}

.nestedには規則が当たりませんが、.containerのcolorを継承するので、.nestedの中の<p>も赤くなります。:scopeではなくp { color: red; }と書くと、.nestedの中の<p>には規則が当たらず、親の.nestedも赤くないので、赤くなりません。

スコープ外の要素は選択できない

@scopeの中のセレクタは、スコープルートの外の要素には当たりません。

css
@scope (.card) {
  /* .cardの外の兄弟要素には当たらない */
  :scope + .sibling { }
}

:scope + .siblingは正しいセレクタとしてcssRulesに残りますが、.cardの次の.siblingには当たりません。

おわりに

@scopeを使うと、命名規則やCSS Modulesに頼らずに、スタイルが当たる範囲を要素の中に限れます。toで入れ子の部分を外すドーナツスコープと、近いスコープのスタイルを勝たせる近接性は、子孫セレクタではできません。