卡片内边距要三个单位,提示区块要两个,普通 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 到生成一个值就结束。
