@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 提供的组合方式。
