css教程网 css教程网365css.cn
公告为您打开互联网世界的窗户关于本站
MODERN · 进阶

自定义属性:变量、作用域与 @property

CSS 变量不只是替换文本,它遵循层叠、可以局部覆盖,配合 @property 还能做类型校验和动画。

更新于 2026-11-05 阅读约 11 分钟 标签 变量 / 主题 / 现代

自定义属性(CSS 变量)是这几年最实用的新能力。它看起来只是「存个值」,实际解决的是主题切换、组件参数化、响应式尺度统一这三类问题。

基本用法与兜底#

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 全局可用,定义在某个容器上则只影响该子树。这是组件参数化的基础:

CSS
.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 结构,靠覆盖变量得到不同外观。比写三套重复规则好维护得多。

主题切换:一处改,全站变#

CSS
: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 声明类型后,一切都不一样了:

CSS
@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 之间补间。

示例真实渲染,改一个值就能看出差别
查看代码
HTML
<div class="spin"></div>
CSS
@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; } }

三个限制要记住#

  1. 媒体查询里不能用变量:@media (min-width: var(--bp)) 无效,断点值必须写死。
  2. 变量不能拼出属性名:var(--p)-color 这种写法不成立。
  3. 未定义的变量会让整条声明失效:color: var(--nope) 不会变成默认色,而是这条 color 直接不生效。加兜底值。

下一篇讲 :has(),它让「根据子元素状态改父元素」第一次成为纯 CSS 的事。