自定义属性:变量、作用域与 @property
CSS 变量不只是替换文本,它遵循层叠、可以局部覆盖,配合 @property 还能做类型校验和动画。
自定义属性(CSS 变量)是这几年最实用的新能力。它看起来只是「存个值」,实际解决的是主题切换、组件参数化、响应式尺度统一这三类问题。
基本用法与兜底#
:root {
--brand: #2b57ff;
--radius: 12px;
--space: 16px;
}
.card {
padding: var(--space);
border-radius: var(--radius);
border: 1px solid var(--brand);
}
/* 第二个参数是兜底值:变量不存在时使用 */
.title { color: var(--title-color, #0d1117); }作用域就是层叠#
变量也遵守继承:定义在 :root 全局可用,定义在某个容器上则只影响该子树。这是组件参数化的基础:
.btn {
--btn-bg: #2b57ff;
--btn-fg: #fff;
background: var(--btn-bg);
color: var(--btn-fg);
}
.btn-danger { --btn-bg: #f4512c; } /* 只改变量,不改规则 */
.btn-ghost { --btn-bg: transparent; --btn-fg: #2b57ff; }同一个 .btn 结构,靠覆盖变量得到不同外观。比写三套重复规则好维护得多。
主题切换:一处改,全站变#
:root {
--bg: #fff; --fg: #0d1117; --line: #e5e9f0; --brand: #2b57ff;
}
[data-theme="dark"] {
--bg: #0b0f17; --fg: #eef2f8; --line: #222b3b; --brand: #7ea1ff;
}
body { background: var(--bg); color: var(--fg); }关键点是语义化命名:用 --bg、--fg、--line,而不是 --white、--gray-100。否则深色模式下变量名和实际颜色对不上,维护会疯。
@property:让变量有类型#
普通变量是「字符串替换」,浏览器不知道它是颜色还是长度,所以不能做过渡动画。用 @property 声明类型后,一切都不一样了:
@property --angle {
syntax: "<angle>";
inherits: false;
initial-value: 0deg;
}
.glow {
background: conic-gradient(from var(--angle), #2b57ff, #ff8a5c, #2b57ff);
transition: --angle .8s ease;
}
.glow:hover { --angle: 180deg; }没有 @property,--angle 无法插值,过渡会瞬间跳变。声明了 syntax: "<angle>" 之后,浏览器知道怎么在 0deg 和 180deg 之间补间。
查看代码
<div class="spin"></div>@property --a { syntax: "<angle>"; inherits: false; initial-value: 0deg; }
.spin {
width: 96px; height: 96px; border-radius: 50%;
background: conic-gradient(from var(--a), #2b57ff, #ff8a5c, #2b57ff);
animation: rot 3s linear infinite;
}
@keyframes rot { to { --a: 360deg; } }三个限制要记住#
- 媒体查询里不能用变量:
@media (min-width: var(--bp))无效,断点值必须写死。 - 变量不能拼出属性名:
var(--p)-color这种写法不成立。 - 未定义的变量会让整条声明失效:
color: var(--nope)不会变成默认色,而是这条color直接不生效。加兜底值。
下一篇讲 :has(),它让「根据子元素状态改父元素」第一次成为纯 CSS 的事。