卡片內距要三個單位,提示區塊要兩個,普通 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 到產出一個值就結束。
