[FEE-11202] CSS Nesting — 巢狀結構
INFO
以巢狀、自給自足的區塊撰寫 CSS 元件規則,直接在瀏覽器中運作,不需要預處理器步驟。
Baseline
此功能為 Baseline Widely Available,Chrome 120+、Firefox 117+、Safari 17.2+ 皆已支援(若在每條巢狀規則中明確寫出 &,Chrome 112+ 也可運作;詳見下方〈瀏覽器支援〉)。
背景
CSS 一直要求你在每一條屬於同一個元件的規則上重複父選擇器。一個簡單的卡片,帶有懸停狀態和啟用變體,就會產生四條獨立規則,每條都要重寫 .card:
.card { background: #fff; border-radius: 8px; padding: 1rem; }
.card:hover { box-shadow: 0 4px 12px rgba(0,0,0,0.1); }
.card .title { font-size: 1.25rem; font-weight: 700; }
.card--active .title { color: #0070f3; }這種重複會造成維護上的隱患。將 .card 重新命名為 .article-card 需要修改每一條規則,將元件移到另一個檔案,也意味著必須重新閱讀每一條規則才能理解它的歸屬。在大型程式庫中,這種重複會導致選擇器漂移:部分規則被更新,其他的卻被遺漏,元件因而隨時間累積廢棄規則與未測試的組合。
預處理器(Sass 於 2006 年、Less 於 2009 年、Stylus 於 2010 年)用巢狀語法解決了這個問題。十五年來,巢狀結構始終只是工具鏈執行的建置時期轉換。原生 CSS 本身,無論預處理器做了什麼,都需要手動重複選擇器。
CSS Nesting(巢狀結構),已在 CSS Nesting Module Level 1 中標準化,將這項能力直接帶入瀏覽器,不需要建置步驟。Sass 開發者使用了十年的相同語法,現在是第一級的瀏覽器功能。
視覺對比
瀏覽器會先將每一條巢狀規則轉換為等效的平鋪選擇器,再計算特異性。這個轉換過程稱為解糖(de-sugaring),也是本文其餘內容所依據的核心機制:
| 巢狀寫法 | 解糖後 | 最終特異性 |
|---|---|---|
.card { .title { color: navy; } } | .card .title { color: navy; } | (0,2,0) |
.card { &:hover { color: navy; } } | .card:hover { color: navy; } | (0,2,0)(一個類別 + 一個偽類) |
.card, #featured { .title { color: navy; } } | :is(.card, #featured) .title { color: navy; } | (1,1,0)(從 :is() 繼承 ID 的特異性) |
第三列是唯一值得牢記的例外:以逗號分隔的父選擇器列表會透過 :is() 解糖,而 :is() 採用其最具體引數的特異性。下方的〈設計思維〉會說明原因。
範例
完整的 .button 元件,包含狀態、變體和子元素
以下範例展示了 CSS 巢狀結構的完整能力。第一個區塊使用原生 CSS 巢狀;第二個區塊顯示它解糖後的等效平鋪 CSS。兩者輸出完全相同,只有撰寫形式不同。
/* ── 原生 CSS 巢狀結構 ──────────────────────────────────────── */
.button {
display: inline-flex;
align-items: center;
gap: 0.5rem;
padding: 0.5rem 1rem;
border: 2px solid transparent;
border-radius: 4px;
font-weight: 600;
cursor: pointer;
background: #0070f3;
color: white;
/* 偽類狀態 — & 必要(非識別字開頭) */
&:hover { background: #0051a8; }
&:focus-visible { outline: 3px solid #0070f3; outline-offset: 2px; }
/* 屬性選擇器 — & 必要 */
&[disabled] { opacity: 0.5; cursor: not-allowed; pointer-events: none; }
/* 修飾符變體 — & 必要(複合選擇器以 & 開頭) */
&.button--secondary {
background: transparent;
border-color: #0070f3;
color: #0070f3;
/* 狀態巢狀在變體內 — 第 2 層 */
&:hover { background: #e6f0ff; }
}
/* 子元素 — 隱式巢狀,& 可選 */
.button__icon { width: 1em; height: 1em; }
}/* ── 等效平鋪 CSS — 相同的特異性,相同的輸出 ──────────────── */
.button {
display: inline-flex;
align-items: center;
gap: 0.5rem;
padding: 0.5rem 1rem;
border: 2px solid transparent;
border-radius: 4px;
font-weight: 600;
cursor: pointer;
background: #0070f3;
color: white;
}
.button:hover { background: #0051a8; }
.button:focus-visible { outline: 3px solid #0070f3; outline-offset: 2px; }
.button[disabled] { opacity: 0.5; cursor: not-allowed; pointer-events: none; }
.button.button--secondary { background: transparent; border-color: #0070f3; color: #0070f3; }
.button.button--secondary:hover { background: #e6f0ff; }
.button .button__icon { width: 1em; height: 1em; }巢狀 @media 查詢
與它們修改的基本規則放在同一位置的響應式覆蓋,比分散在檔案底部的覆蓋更容易審查。
.card {
display: grid;
grid-template-columns: 1fr;
gap: 1rem;
padding: 1rem;
/* 響應式覆蓋巢狀在元件規則內 */
@media (min-width: 768px) {
grid-template-columns: auto 1fr;
padding: 1.5rem;
}
.card__header {
font-size: 1.125rem;
font-weight: 700;
@media (min-width: 768px) {
font-size: 1.25rem;
}
}
}巢狀 @container 查詢
容器查詢的巢狀方式與媒體查詢完全相同。容器查詢讀取最近的 container-type 祖先的寬度,而非視口。
.sidebar {
container-type: inline-size;
}
.sidebar .widget {
display: block;
padding: 0.75rem;
@container (min-width: 300px) {
display: flex;
gap: 1rem;
padding: 1rem;
}
.widget__label {
font-size: 0.875rem;
color: #555;
}
}在 @layer 內巢狀
在級聯層(cascade layer)內巢狀,可在不改變巢狀本身運作方式的情況下,限定元件規則的作用域。
@layer components {
.chip {
display: inline-flex;
align-items: center;
padding: 0.25rem 0.75rem;
border-radius: 9999px;
font-size: 0.875rem;
background: #f0f0f0;
color: #333;
&:hover { background: #e0e0e0; }
&.chip--active {
background: #0070f3;
color: white;
&:hover { background: #0051a8; }
}
}
}@layer components 內的規則優先順序低於未分層的規則,無論特異性如何。巢狀結構在層區塊內正常保留。
從 Sass 巢狀遷移
Sass 巢狀和原生 CSS 巢狀在最常見的模式上語法幾乎相同。主要差異如下:
| 模式 | Sass | 原生 CSS |
|---|---|---|
| 偽類 | &:hover | &:hover(完全相同) |
| 子元素 | .button__icon 或 &__icon | .button__icon(無 & 後綴連接) |
| 修飾符變體 | &--secondary | &.button--secondary(無字串連接) |
| 類型選擇器 | span | span 或 & span |
關鍵差異:原生 CSS 巢狀不支援 Sass 中用於 BEM 修飾符的 & 字串連接模式。Sass 中的 &--secondary 會產生 .button--secondary。在原生 CSS 中,&--secondary 是無效的(選擇器不能以 -- 開頭)。請使用完整的類別名稱:&.button--secondary。
最佳實踐
- SHOULD 在所有針對現代瀏覽器的新程式碼中使用原生 CSS 巢狀結構。從 Chrome 120 / Firefox 117 / Safari 17.2 起,瀏覽器支援已達 Baseline Widely Available。
- MUST 在巢狀選擇器以偽類(
&:hover)、偽元素(&::after)或屬性選擇器(&[disabled])開頭時使用&。在這些情況下省略&不會造成語法錯誤,而是會靜默地改變語意:瀏覽器會插入後代組合器,因此.card { :hover {} }比對的是被懸停的後代元素(.card :hover),而非卡片本身(.card:hover)。若以組合器開頭(> .child、+ .sibling),則不需要明確寫出&,因為&在這個位置是隱含的。 - SHOULD NOT 巢狀超過 3 層。深層巢狀會產生高特異性選擇器,使級聯更難以覆蓋。帶有修飾符變體、其子元素又有狀態的元件已達到 3 層。超出這個範圍的部分請考慮攤平。
- SHOULD NOT 使用
@nest。@nestat-rule 出現在較早的 CSS Nesting 草案中(2021–2022 年),但在 Chrome 推出穩定版巢狀支援之前已從規格書中移除:Chrome 112(2023 年 4 月)推出的是不含@nest的&語法。現代瀏覽器不支援它;請改用&。 - SHOULD 在使用遺留建置系統時驗證你的 PostCSS 流程。
postcss-nestingv10.x 及更早版本實作了已棄用的@nest草案,可能無法正確處理原生巢狀語法。自 v11.1.0 起,現代(非@nest)語法已是預設;升級到 v11.3.0 或更新版本,可在使用@nest時取得執行期警告。 - MAY 將巢狀結構與
@layer結合,將元件規則限定在一個層(layer)內。在@layer區塊內巢狀是有效的,並可自然地與級聯層系統組合使用。 - MAY 在規則區塊內巢狀
@media和@container查詢。這使響應式覆蓋與它們修改的基本宣告保持在同一位置。
設計思維
為何 CSS 25 年以上沒有巢狀結構
CSS 解析器有一個結構性的歧義問題。考慮這個沒有 & 符號的假設語法:
div {
span {
color: red;
}
}解析器無法確定 span { color: red; } 是巢狀規則還是格式錯誤的宣告。CSS 宣告是 property: value 對。序列 span { ... } 不符合該模式,但解析器被設計為具有容錯性,會跳過未知構造而非失敗。一個簡單的解析器會靜默地將巢狀區塊作為無效宣告丟棄。
& 巢狀選擇器(正式名稱:「nest 選擇器」)通過提供明確的信號解決了這個問題。當解析器看到 & 時,它知道正在讀取巢狀規則,而非宣告。之後的選擇器相對於外部規則。
div {
&:hover { color: red; } /* 明確地是巢狀規則 */
}這就是為什麼 CSS 工作組在最初的巢狀設計(2023 年)中要求 &。瀏覽器廠商隨後在 Chrome 120 和 Safari 17.2 中推出了「放鬆解析」,這項擴展允許巢狀選擇器以類別、ID、屬性或類型選擇器開頭,不需要 &:
.card {
.title { font-weight: 700; } /* 隱式巢狀 — Chrome 120 起有效 */
}解析器解決這個歧義的方式,是先嘗試將該結構解析為宣告;如果無法產生有效的 property: value 對,就會重新開始,把相同的 token 重新解析為巢狀樣式規則。這需要實質上無界的前瞻(lookahead),因為解析器在消耗完整個結構之前,無法得知哪一種解讀才是正確的。
Sass 如何普及了這個模式
Sass(Syntactically Awesome Style Sheets)在 2006 年將巢狀作為其核心賣點之一引入。這個模式傳播到 Less(2009 年)、Stylus(2010 年),最終傳播到 CSS-in-JS 生態系統(styled-components、Emotion)。到 2015 年,巢狀是撰寫元件 CSS 的主流方式,儘管它始終在建置時期被編譯掉。
當 CSS 工作組認真開始標準化巢狀(第一份草案於 2013 年提出)時,Sass 語法已經訓練了整整一代前端開發者。最終的原生語法與 Sass 使用者的期望非常接近,這大幅降低了採用的學習曲線。
特異性(Specificity)不變:巢狀結構是語法糖
關於 CSS 巢狀結構最重要的一點是:它不改變特異性。巢狀規則在計算特異性之前,會被瀏覽器解糖(de-sugar)為等效的平鋪選擇器。
/* 用巢狀撰寫 */
.card {
.title { color: navy; }
}
/* 解糖後的等效平鋪選擇器 */
.card .title { color: navy; }兩種形式的特異性都是 (0,2,0),來自兩個類別選擇器。巢狀純粹是組織性的。它不會給巢狀規則任何相對於針對同一元素的平鋪規則的優先順序優勢。
當父選擇器是選擇器列表時,有一個特異性細節需要注意:
.card, #featured {
.title { color: navy; }
}瀏覽器將此解糖為 :is(.card, #featured) .title。:is() 偽類採用其最具體引數的特異性:在本例中為 #featured,一個特異性為 (1,0,0) 的 ID。.title 規則因此具有特異性 (1,1,0),高於你對基於類別的元件選擇器所期望的。對混合了 ID 和類別選擇器列表作為父選擇器的情況要謹慎。
@nest:一個錯誤的開始
最初的 CSS Nesting 語法在較早的草案中(2021–2022 年)包含了 @nest at-rule。它在 2022 年底/2023 年 1 月的「相對選擇器 Option 3」修訂版中被移除,早於 Chrome 112(2023 年 4 月)推出不含 @nest 的 & 語法:
/* @nest — 請勿使用 */
.card {
@nest &:hover { box-shadow: 0 4px 12px rgba(0,0,0,0.1); }
}任何當前瀏覽器版本均不支援 @nest;使用它的程式碼會被靜默忽略。如果你在程式庫中遇到 @nest,請用 & 替換它。
原生巢狀與 CSSNestedDeclarations 介面
2024 年,CSSOM 擴展了 CSSNestedDeclarations 介面,以支援在巢狀規則內包含裸宣告的規則區塊,而不會創建非預期的「空」規則。這解決了一個邊緣情況:放置在同一區塊中巢狀規則之後的宣告,在級聯中被視為屬於獨立規則。此修復已在 Chrome 130、Firefox 132 和 Safari 18.2 中落地。
瀏覽器支援
| 瀏覽器 | 首次支援版本 | 備註 |
|---|---|---|
| Chrome | 112 | 初始支援需要 &;放鬆解析(隱式巢狀)於 Chrome 120 |
| Firefox | 117 | 首次穩定版即包含放鬆解析 |
| Safari | 17.2 | 首次穩定版即包含放鬆解析 |
| Edge | 112 | 基於 Chromium;放鬆解析於 Edge 120 |
CSS 功能偵測:
@supports selector(&) {
/* 支援 CSS 巢狀結構 */
.card {
&:hover { box-shadow: 0 2px 8px rgba(0,0,0,0.12); }
}
}JavaScript 功能偵測:
const supportsNesting = CSS.supports('selector(&)');截至 2026 年,CSS 巢狀結構已是 Baseline Widely Available。放鬆解析規則(隱式巢狀,類別/ID/屬性/類型選擇器不需要 &)在 Chrome 120+、Firefox 117+ 和 Safari 17.2+ 中受支援。對於必須支援 Chrome 112–119 的專案,請在所有巢狀規則上明確使用 &。結果完全相同,只是更冗長。
建置工具相容性
如果你的專案使用 PostCSS 流程,請驗證你的 postcss-nesting 版本:
| 版本 | 狀態 | 備註 |
|---|---|---|
| v10.x 及更早 | 不安全 / @nest 草案 | 實作已棄用的 @nest 規格;可能無法正確處理原生巢狀語法 |
| v11.1.0(2023-01-31)及以後 | 現代語法 | 採用現代、非 @nest 規格 |
| v11.3.0(2023-06-14)及以後 | 現代語法 + @nest 警告 | 使用 @nest 時發出執行期警告,可透過 silenceAtNestWarning 選項關閉 |
- 目前最新版本:v14.0.1(2026-07-23)
postcss-nesting本身就是 csstools 維護的外掛。追蹤尚未穩定語法提案的變體是@csstools/postcss-nesting-experimental,而非獨立的「nesting-rules」套件。
如果你的建置流程使用 Lightning CSS 而非 PostCSS,原生巢狀不需要額外的外掛:Lightning CSS 會自行解析並降級(downlevel)巢狀規則。這是 Parcel 預設的 CSS 轉換器,Tailwind CSS v4 也基於同樣的理由建構在 Lightning CSS 之上,因此無論使用哪一種工具鏈的專案都完全不需要 postcss-nesting。
如果你的目標瀏覽器原生支援巢狀,且你的建置流程不轉換巢狀,則根本不需要外掛。在加入巢狀轉換之前,請先檢查你的 browserslist 設定。
延伸閱讀
- FEE-11200 CSS @scope:
@scope與巢狀自然搭配。將元件樣式巢狀在規則區塊內,再用@scope包裝元件,防止選擇器從外部洩漏。 - FEE-11203 CSS @layer(即將推出):
@layer與巢狀可以無縫組合。將巢狀元件區塊放在@layer內,可同時獲得巢狀的撰寫清晰度和層的級聯優先順序控制。
參考資料
- CSS nesting — MDN Web Docs
- Nesting — web.dev Learn CSS
- CSS Nesting Module Level 1 — W3C
- CSS nesting improves with CSSNestedDeclarations — web.dev
- CSS nesting — Can I use
- CSS nesting relaxed syntax update: Chrome for Developers
- postcss-nesting CHANGELOG: csstools/postcss-plugins
- Getting Started: Lightning CSS