@property 是解决 CSS 自定义属性动画的关键,因其为变量声明类型(syntax)和继承性(inherits),使浏览器能识别并动画化 --my-var;必须在 :root 声明,且 transition 目标须为该变量本身。

为什么 @property 是解决 CSS 自定义属性动画的关键
原生 CSS 变量(--my-color)默认不支持 transition 或 animation,浏览器无法推断其类型和取值范围,直接写 transition: --my-opacity 0.3s 会静默失效。而 @property 的作用就是「告诉浏览器:这个变量是数字/颜色/长度,并且允许动画」——它补全了 CSS 自定义属性的类型系统。
@property 必须声明 syntax 和 inherits 才能生效
漏掉任一参数,动画仍不会触发。常见错误是只写 syntax: ' 却忽略 inherits,导致变量在子元素中不可继承、动画中断;或把 syntax 写成 ' 却赋值 10(缺单位),浏览器直接丢弃该次变更。
-
syntax必须用单引号包裹,且值需为标准语法关键词:'、' '、' '、' ',不支持组合如' '| ' -
inherits推荐显式写true或false,不要省略——即使你没打算继承,也应写inherits: false表明意图 - 必须在
:root或全局作用域声明,不能嵌套在媒体查询或选择器内
正确示例:
@property --fade-amount {
syntax: '<number>';
inherits: false;
initial-value: 0;
}</number>
配合 transition 使用时,变量名必须完全匹配
过渡目标必须是 @property 声明的变量名本身,不能是它的计算结果。比如声明了 --fade-amount,就只能写 transition: --fade-amount 0.4s ease;若试图过渡 opacity 并在 style 中用 opacity: var(--fade-amount),动画依然不会平滑——因为 opacity 本身没变,只是引用了变量。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
- 变量更新必须通过
element.style.setProperty('--fade-amount', '0.8')或:hover { --fade-amount: 1; }等直接修改变量值的方式触发 - 不能依赖 JS 修改 class 后间接影响变量,除非该 class 内联写了新变量值
- 多个变量同时动画需分别声明
@property,并在transition中用逗号分隔:transition: --fade-amount 0.3s, --scale-factor 0.2s
颜色动画要慎用 syntax,兼容性有坑
syntax: ' 在 Chrome 110+ 和 Safari 16.4+ 支持,但 Firefox 完全不支持;且它只接受标准颜色关键词(red)、十六进制(#ff0000)、rgb()、hsl(),不接受 color-mix() 或 oklch() 等新函数。一旦写错格式,整个变量更新失败,动画卡死。
- 更稳妥的做法:用
控制 HSL 的 H/S/L 分量,再在 CSS 中组合:background: hsl(var(--hue), var(--sat), var(--light)) - 初始值
initial-value必须符合syntax类型,initial-value: 'red'对合法,但initial-value: 120就非法 - 调试时可临时加
console.log(getComputedStyle(el).getPropertyValue('--my-var')),确认值是否被正确解析
变量动画真正难的不是写法,而是想清楚哪些状态值得用 @property 驱动——它适合控制单一维度的渐进变化(透明度、偏移、缩放),不适合替代完整动画逻辑。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










