@mixin 想讓 CSS 做的事,可以從這段看出來:定義一組外框樣式,再由兩個選擇器各自套用。

/* 草案語法:定義與套用 */
@mixin --panel-frame() {
  border: 1px solid #777777;
  border-radius: 0.5rem;
  padding: 1.5rem;
}
 
.site-card {
  @apply --panel-frame();
}
 
.site-notice {
  @apply --panel-frame();
}

--panel-frame 是 mixin 的名字,@apply 指定套用位置。這次重用的東西是一整組宣告;@function則算出一個值,交給 padding 等屬性使用。

定義與使用的位置不同

依定義規則,名稱以 -- 開頭,mixin 定義不能放進一般樣式規則內。例子因此在頂層定義,再在 .site-card、.site-notice 裡使用 @apply。套用規則可出現在樣式規則或其中的巢狀群組規則內。

無參數時也能省略括號,寫成 @apply --panel-frame;。這裡保留括號,方便下一步加入參數。它引用的是 mixin 名稱,不是把現成 class 傳給 @apply。

把最初的例子讀成「在此放入那組規則」,就能看懂兩個元件如何共用外框。加入參數後,還需要追蹤值在哪個範圍可見,不能只按文字複製來理解。展開的樣式也仍受 cascade 約束,來源、layer、權重與順序都繼續生效。

把兩個差異留在呼叫處

假設文章卡片與版本提示共用圓角,外框和標題應使用同一個強調色;提示的內距則比較小。後面的例子採用這組 HTML:

<article class="site-card">
  <h2 class="site-panel-title">安裝指南</h2>
  <p>從專案的第一個頁面開始。</p>
</article>
 
<aside class="site-notice">
  <h2 class="site-panel-title">版本提醒</h2>
  <p>升級前請先閱讀變更紀錄。</p>
</aside>

用下面這份 CSS 取代最初的定義。參數只收顏色與內距,圓角仍維持共同設定:

/* 草案語法:參數、預設值與巢狀規則 */
@mixin --panel-frame(
  --accent <color>: #777777,
  --space <length>: 1.5rem
) {
  border: 1px solid var(--accent);
  border-radius: 0.5rem;
  padding: var(--space);
 
  & > .site-panel-title {
    margin-block: 0 0.75rem;
    color: var(--accent);
  }
}
 
.site-card {
  @apply --panel-frame();
}
 
.site-notice {
  @apply --panel-frame(#45687d, 1rem);
}

卡片採用預設值;提示傳入 #45687d 和 1rem。--accent <color> 接受顏色,--space <length> 接受長度,冒號後是預設值。百分比不屬於這裡的 <length>。參數語法

除了顏色和內距,這個 mixin 也把標題的位置納入共用約定:.site-panel-title 必須是容器的直接子元素。若卡片把標題多包一層,標題規則就不會命中。這時我會拆開標題與外框的樣式;否則每多一種內部結構,原本單純的外框都要跟著修改。

參數用 var() 讀取,卻不是在元素上公開新增一般自訂屬性。草案把它們當成私有屬性,同名參數會遮蔽外部值,而且值只對套用元素及其後代可見。若把選擇器改成 & + * 之類的兄弟選擇器,就不能假設兄弟也能讀到傳入的顏色。參數與作用範圍

@contents 留下一個放樣式的位置

另一種重用發生在條件。假設兩種元件都在同一個 viewport 門檻進入窄版,但卡片要改排列,提示要縮內距、加粗側邊框。以下接在前一份 CSS 後面:

/* 草案語法:共用條件,各自提供內容 */
@mixin --compact-layout() {
  @media (width <= 40rem) {
    @contents;
  }
}
 
.site-card {
  @apply --compact-layout() {
    display: grid;
    gap: 0.75rem;
    padding: 1rem;
  }
}
 
.site-notice {
  @apply --compact-layout() {
    padding: 0.75rem;
    border-inline-start-width: 3px;
  }
}

@apply 後面的區塊由呼叫者提供;@contents 決定放進哪裡。這裡共用的是 40rem 條件,各自怎麼改仍留在各自的樣式裡。@contents 定義

如果兩個元件其實應該看不同容器的空間,共用 viewport 門檻就不合理。40rem 只是本例的決定,不是可直接套到每個網站的裝置分類。

@contents 可以帶預設區塊,只有呼叫者沒傳內容時才使用。傳空區塊仍算有傳,只是沒有宣告。本例沒有預設區塊,所以單獨呼叫 --compact-layout()、不附內容,不會替元件增加樣式。

共用的條件出現在多個元件中,而各元件又有自己的變化時,這個機制比較有價值。回到眼前只有兩個元件的例子,一個 @media 裡並列兩條規則就已經很好讀。下一段先用現在可執行的 CSS 完成同一件事。

今天要做這個外框,我會先用普通 CSS

同樣的 HTML 不必等 mixin。以下透過選擇器分組集中宣告,自訂屬性提供差異,可以作為現在的實作:

:root {
  --panel-radius: 0.5rem;
}
 
.site-card,
.site-notice {
  border: 1px solid var(--panel-accent, #777777);
  border-radius: var(--panel-radius);
  padding: var(--panel-space, 1.5rem);
}
 
.site-card > .site-panel-title,
.site-notice > .site-panel-title {
  margin-block: 0 0.75rem;
  color: var(--panel-accent, #777777);
}
 
.site-notice {
  --panel-accent: #45687d;
  --panel-space: 1rem;
}

若能調整 HTML,也可以把共同選擇器改成 .site-panel,讓兩個元件各加上這個 class。var() 負責替換值,不會插入整組宣告;分組或共用 class 已經解決這裡的宣告重用。自訂屬性規格

如果日後要在不同元件樣式中組合這組規則,或使用處需要明確參數,或 HTML 不方便共用 class,我才會重新評估 mixin。評估時也要看呼叫處:若每次都改掉一半設定,還要新增圖示、背景、標題大小等開關,這組規則很可能已經包得太多,應先拆小。

熟悉 Sass 也不代表可以直接搬語法。Sass 使用 $ 參數和 @include,由編譯器輸出 CSS;這份原生提案使用 -- 名稱、@apply 和 CSS 的值系統。Sass mixin

截至 2026 年 10 月 30 日,草案的求值章節仍有改寫至新 @private 模型的待辦,也留著舊 @result 範例。上文因此依第 5.1–5.4 節解說公開語法;第 5.5 節的內部展開步驟尚不能當成定案行為。草案中的待辦

在這個例子裡,我會讓共用區塊停在外框。卡片與提示各自的內容和變化,仍由各自的樣式處理。將來提示不再需要這層外框,移除一次套用就能離開,才是我希望 mixin 提供的組合方式。