@scopeでCSSのスタイルを特定の要素の中だけに効かせる
@scopeは、CSSのスタイルが効く範囲をある要素の中に限るアットルールです。BEMやCSS Modulesを使わずにコンポーネントの中だけにスタイルを当てる書き方と、内側に下限を設けるドーナツスコープ、近接性を説明します。
- 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の後の括弧にスコープルートのセレクタを書きます。
@scope (.card) {
/* .card内のh2要素にのみ適用 */
h2 {
color: var(--color-primary);
}
/* .card内のp要素にのみ適用 */
p {
color: var(--color-text);
}
}インライン形式
<style>要素の中に括弧を付けずに@scopeと書くと、<style>要素の親要素がスコープルートになります。
<div class="card">
<style>
@scope {
/* .card内のh2要素にのみ適用 */
h2 {
color: red;
}
}
</style>
<h2>カードのタイトル</h2>
</div>
<h2>カードの外のタイトル</h2>開くと、カードのタイトルだけが赤くなり、カードの外のタイトルは黒のままです。
ドーナツスコープ
toの後にセレクタを書くと、スコープに下限(スコープリミット)を設けられます。スコープルートからスコープリミットの手前までの、穴の開いた範囲にだけスタイルが当たるので、ドーナツスコープと呼ばれます。
@scope (.article) to (.nested-content) {
img {
border: 2px solid var(--color-border);
border-radius: var(--radius-md);
}
}次のHTMLでは、.articleの中の<img>にスタイルが当たり、.nested-contentの中の<img>には当たりません。
<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>@scope (.article) to (.nested-content) {
img {
border: 4px solid steelblue;
border-radius: 0.5rem;
}
}
/* チェックを外しているあいだは、@scopeを使わない.article imgも当てる */
body:has(#scoped:not(:checked)) .article img {
border: 4px solid steelblue;
border-radius: 0.5rem;
}
.article,
.nested-content {
margin-block: 0.5rem;
padding-inline: 1rem;
border: 1px dashed GrayText;
}結果の欄でチェックを外して.article imgに切り替えると、.nested-contentの中の画像にもボーダーが付きます。
:scope疑似クラス
@scopeの中でスコープルート自身にスタイルを当てるときは、:scope疑似クラスを使います。
@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だけが下限になります。
@scope (.article) to (:scope > .nested-content) {
img {
border: 2px solid var(--color-border);
border-radius: var(--radius-md);
}
}<label><input type="checkbox" id="child" 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>
<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>/* チェックを入れているあいだは、直接の子の.nested-contentだけを下限にする */
@scope (body:has(#child:checked) .article) to (:scope > .nested-content) {
img {
border: 4px solid steelblue;
border-radius: 0.5rem;
}
}
@scope (body:has(#child:not(:checked)) .article) to (.nested-content) {
img {
border: 4px solid steelblue;
border-radius: 0.5rem;
}
}
.article,
.nested-content {
margin-block: 0.5rem;
padding-inline: 1rem;
border: 1px dashed GrayText;
}1つ目の.nested-contentは.articleの直接の子なので、中の<img>にはスタイルが当たりません。2つ目は<div>を挟んだ孫なので下限にならず、中の<img>にもスタイルが当たります。
結果の欄でチェックを外して下限をto (.nested-content)に切り替えると、孫の.nested-contentの中の画像からもボーダーが消えます。
スコープの近接性
@scopeで、カスケードにスコープの近接性という基準が加わりました。詳細度が同じスタイルがぶつかったときは、要素からスコープルートまでの階層が少ないほうのスタイルが勝ちます。
@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);
}
}<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>@scope (.info-box) {
.message {
color: white;
background-color: steelblue;
}
}
@scope (.warning-box) {
.message {
color: black;
background-color: gold;
}
}
/* チェックを外しているあいだは、詳細度の高い子孫セレクタの規則が上の規則に勝つ */
body:has(#scoped:not(:checked)) {
.info-box .message {
color: white;
background-color: steelblue;
}
.warning-box .message {
color: black;
background-color: gold;
}
}
.info-box,
.warning-box {
margin-block: 0.5rem;
padding-inline: 1rem;
border: 1px dashed GrayText;
}
.message {
padding: 0.5rem;
}いちばん内側の.messageは、.warning-boxより.info-boxのほうが近いので、.info-boxのスタイルになります。@scopeを使わずに.info-box .messageと.warning-box .messageで書くと、詳細度が同じなので、後に書いた.warning-boxのスタイルになります。
結果の欄でチェックを外して@scopeを使わない書き方に切り替えると、いちばん内側のメッセージが警告の色に変わります。
近接性が効くのは、詳細度が同じときだけです。@scopeの中のh2の詳細度はh2の分だけで、スコープルートの.cardは足されません。
.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のようにスタイルを閉じ込めるのではなく、スタイルが当たる要素を絞るだけです。
@scope (.container) to (.nested) {
:scope {
color: red;
}
}.nestedには規則が当たりませんが、.containerのcolorを継承するので、.nestedの中の<p>も赤くなります。:scopeではなくp { color: red; }と書くと、.nestedの中の<p>には規則が当たらず、親の.nestedも赤くないので、赤くなりません。
スコープ外の要素は選択できない
@scopeの中のセレクタは、スコープルートの外の要素には当たりません。
@scope (.card) {
/* .cardの外の兄弟要素には当たらない */
:scope + .sibling { }
}:scope + .siblingは正しいセレクタとしてcssRulesに残りますが、.cardの次の.siblingには当たりません。
おわりに
@scopeを使うと、命名規則やCSS Modulesに頼らずに、スタイルが当たる範囲を要素の中に限れます。toで入れ子の部分を外すドーナツスコープと、近いスコープのスタイルを勝たせる近接性は、子孫セレクタではできません。