卡片內距要三個單位,提示區塊要兩個,普通 CSS 就能算。後面的例子共用這組 HTML:

<article class="site-card">
  <h2>安裝指南</h2>
  <p>從專案的第一個頁面開始。</p>
</article>
<aside class="site-notice">
  <h2>版本提醒</h2>
  <p>升級前請先閱讀變更紀錄。</p>
</aside>
:root {
  --space-unit: 0.5rem;
}
 
.site-card {
  padding: calc(var(--space-unit) * 3);
}
 
.site-notice {
  padding: calc(var(--space-unit) * 2);
}

根字級 16px 時,一個單位是 8px,兩個內距分別為 24px、16px。如果只需要這兩次計算,原寫法就能留下;需要讓多個元件共同維護公式時,再替它命名:

:root {
  --space-unit: 0.5rem;
}
 
@function --space(--steps <number>: 1, --unit <length>: 0.5rem)
  returns <length> {
  result: calc(var(--steps) * var(--unit));
}
 
.site-card {
  padding: --space(3, var(--space-unit));
}
 
.site-notice {
  padding: --space(2, var(--space-unit));
}

函式版的結果仍是 24px、16px;差別在於計算有了名字,倍率與單位從呼叫處傳入。以下範例以支援 @function 的瀏覽器為前提,這項能力從 Chrome 139 開始提供。16px 是方便比較結果的測試條件,並非要求網站固定使用者字級;跨瀏覽器的基準寫法留在文末。

引數寫在哪裡,依賴就在哪裡

函式與參數名稱以 -- 開頭,使用時直接寫在屬性值中:padding: --space(...)。不需要 @apply,也不是 var(--space(...))。var(--steps) 讀取參數,result 描述結果,returns <length> 限制輸出型別。函式定義

這個例子的 --space() 得到 0.5rem,--space(3) 得到 1.5rem,--space(3, 6px) 則是 18px。<length> 不含百分比。型別與預設值可以省略,但保留下來能交代這個函式接受什麼。

預設的 0.5rem 寫在函式定義裡,不會因為根元素的 --space-unit 改成 0.75rem 就跟著變。要使用 token,便像例子那樣把 var(--space-unit) 傳進去。我偏好先把依賴寫明,尤其是交給別人維護的共用函式。

為什麼改了單位,還是 24px?

把下面這段獨立搭配前面的 HTML。卡片把單位改成 0.25rem,內距卻仍是 24px:

:root {
  --space-unit: 0.5rem;
  --card-space: calc(var(--space-unit) * 3);
}
 
.site-card {
  --space-unit: 0.25rem;
  padding: var(--card-space);
}

--card-space 在根元素就解析了其中的 var(--space-unit),之後才被繼承。卡片上的新單位不會回頭重算根元素的引用。自訂屬性的求值與繼承

要讓卡片使用自己的單位,直接將 calc(var(--space-unit) * 3) 寫在卡片上就能解決。若這份計算確實需要共用,函式也可以在使用時讀取元素的單位:

:root {
  --space-unit: 0.5rem;
}
 
@function --local-space(--steps <number>: 1) returns <length> {
  result: calc(var(--space-unit, 0.5rem) * var(--steps));
}
 
.site-card {
  --space-unit: 0.25rem;
  padding: --local-space(3);
}
 
.site-notice {
  padding: --local-space(2);
}

現在卡片是 12px,提示仍是 16px。函式裡沒有名為 --space-unit 的參數或區域變數,因此讀取使用元素的自訂屬性。函式作用域

同樣的 12px,也能用前一版 --space(3, var(--space-unit)) 明確傳入卡片的 0.25rem 得到。--local-space(3) 比較短,但藏了一項外部依賴,必須在使用約定中交代;同名參數或區域變數還會遮蔽外部值。短一個引數,不一定比較容易追查。

result 不會提前返回

下面這個版本在 viewport 不超過 40rem 時,把間距縮成四分之三。它是案例的版面選擇,不是通用的手機定義:

:root {
  --space-unit: 0.5rem;
}
 
@function --responsive-space(--steps <number>: 1) returns <length> {
  --density: 1;
 
  @media (width <= 40rem) {
    --density: 0.75;
  }
 
  result: calc(var(--space-unit, 0.5rem) * var(--steps) * var(--density));
}
 
.site-card {
  padding: --responsive-space(3);
}
 
.site-notice {
  padding: --responsive-space(2);
}

根字級與預設字級皆為 16px 時,800px 視窗得到 24px、16px;600px 視窗得到 18px、12px。--density 是函式區域變數,不會變成元素上供其他 CSS 使用的 token。

媒體條件改變的是參與求值的宣告。它不會讓 result 變成提前返回的指令;下面這個函式即使符合窄版條件,結果仍是 1rem:

@function --always-one() returns <length> {
  @media (width <= 40rem) {
    result: 0.75rem;
  }
 
  result: 1rem;
}

後面的 result 蓋過前面的值。它不是 JavaScript 的 return,不會先遇到結果就停止。執行模型與條件

我會把基準值放前面、條件覆寫放後面,或像前一例使用區域變數,最後只寫一份公式。若兩個元件根本不共用窄版條件,則把媒體查詢留在各自規則裡。

上一行 padding,不是所有錯誤的退路

以下函式的倍率沒有預設值,卻傳入了 red:

@function --strict-space(--steps <number>) returns <length> {
  result: calc(var(--steps) * 0.5rem);
}
 
.site-card {
  padding: 24px;
  padding: --strict-space(red);
}

在支援函式的瀏覽器中,這個引數不符合 <number>,呼叫在計算值階段失效。padding 會得到初始值 0,不會重新選取上一行的 24px。省略必要引數的 --strict-space() 也會失效。其他屬性還要依自身的繼承行為判斷,不能一概套用 0。計算值階段失效

有預設值時又不同。前面的 --space() 為倍率提供了 1,因此 --space(red) 會嘗試使用預設值,得到 0.5rem。引數解析允許這種處理,所以錯誤呼叫也可能看起來正常。

通過函式的型別檢查,也還要符合使用屬性的限制。負數符合 <number>,產出的負長度可用於 margin,卻不能用於 padding。因此要連同呼叫位置檢查,不能只看函式是否產出長度。

現在採用,需要留哪一份基準?

2026 年 10 月 30 日重新核對的 MDN 相容性資料仍記錄:Chrome/Chrome Android 與 Edge 從 139 支援,Firefox 尚未支援,Safari/iOS Safari 標示 preview。這個 preview 標記不能當成穩定版已普及;CSSWG 編輯草案也仍可能調整。

需要保留跨瀏覽器版面時,可以讓原本的計算作為基準,再隔開增強版本。以下是完整 CSS:

:root {
  --space-unit: 0.5rem;
}
 
.site-card {
  padding: calc(var(--space-unit) * 3);
}
 
.site-notice {
  padding: calc(var(--space-unit) * 2);
}
 
@supports at-rule(@function) {
  @function --space(--steps <number>: 1, --unit <length>: 0.5rem)
    returns <length> {
    result: calc(var(--steps) * var(--unit));
  }
 
  .site-card {
    padding: --space(3, var(--space-unit));
  }
 
  .site-notice {
    padding: --space(2, var(--space-unit));
  }
}

at-rule(@function) 查詢本身也需要支援。瀏覽器若不認得查詢,即使能執行函式,也會留下基準樣式。這裡兩條路外觀相同,代價是暫時維護兩份計算。

不要改用 @supports (padding: --space(3)) 檢查函式是否存在。在支援自訂函式的引擎裡,換成未定義的名稱也可能回報 true;宣告可解析,不代表呼叫成功。at-rule() 同樣不會替每個引數把關。

2026 年 10 月 27 日的範例核對使用本機 Chromium、Playwright WebKit,以及關閉 CSSFunctions 的 Chromium,比較結果與基準樣式。Playwright WebKit 不代表 Safari 穩定版,這份測試也不能推定 Firefox 的支援。

我的採用理由會是共同維護計算,而非把每次運算都包成函式。只有兩次乘法時,calc() 已經很好讀。若要重用的是多個宣告與巢狀規則,則接著看 @mixin 草案;@function 到產出一個值就結束。