@property不能防注入,因其仅做语法校验而非运行时沙箱;它可拦截非法赋值(如setProperty传入"123"导致静默失败并回退initial-value),但无法阻止JS合法调用造成的布局破坏等注入风险。

为什么@property不能防注入,但能拦住非法赋值
@property 本身不提供安全防护能力,它只在 CSS 引擎解析阶段做语法校验,不是运行时沙箱。攻击者仍可调用 document.documentElement.style.setProperty('--color', '123'),此时浏览器会静默失败,变量值保持上一次合法值——这属于“拦截非法值”,而非“阻止篡改行为”。真正的注入风险(如布局破坏、UI 隐藏)依然存在,因为 JS 调用本身完全合法。
@property 必须配合 initial-value 才能兜底
没有 initial-value 的 @property 声明是无效的,浏览器直接忽略整条规则。这意味着:即使你写了 syntax: "<color>"</color>,只要漏了 initial-value,变量就退化为普通字符串,transition 和动画照样失效,且无法回退。
-
initial-value必须是符合syntax类型的合法值:比如initial-value: red可以,initial-value: 123会报解析错误 - 它只在变量“未定义”或“当前值被拒绝”时生效,不是每次 setProperty 失败都触发
- 常见翻车点:
initial-value: transparent合法;initial-value: inherit在inherits: false下也合法;但initial-value: auto对<color></color>类型无效
@property 声明位置错一个层级就彻底失效
必须写在 :root 或顶层 @layer 中,嵌套进任何选择器(包括 @media、.theme-dark)都会被浏览器静默忽略。你查不到报错,transition: --color 0.3s 就是不动——这是最常被忽略的部署陷阱。
- 正确:
:root { @property --primary-color { syntax: "<color>"; inherits: false; initial-value: #007bff; } }</color> - 错误:
.card { @property --size { syntax: "<length>"; ... } }</length>→ 规则消失,变量无类型 - 错误:
@media (prefers-color-scheme: dark) { @property --bg { ... } }→ 同样静默失效
Chrome/Edge 120+ 才支持,Firefox 和 Safari 还没实现
截至 2026 年 11 月,@property 仅在 Chromium 内核中可用。你在 Safari 或 Firefox 里写的整套类型校验逻辑,实际不会执行,变量始终是字符串。别指望靠它做跨浏览器一致的行为约束。
立即学习“前端免费学习笔记(深入)”;
如果项目需兼容非 Chromium 浏览器,必须回归防御性 JS 校验 + calc()/clamp() 硬编码替代动态变量,否则所谓“防止非法值”只是幻觉。真正难防的从来不是错输颜色,而是有人把 --header-height 设成 0px 让风控栏消失——@property 对这种攻击完全无感。


















