大网数据广告活动
Web 标准与前端开发

初始值

· 52CE 我爱测

**`initial-value`** CSS描述符在使用@property at-rule的时候是必需的,除非 syntax 属性接受了任何有效的 token 流。它为属性设置初始值。

initial-value CSS描述符在使用@property at-rule的时候是必需的,除非 syntax 属性接受了任何有效的 token 流。它为属性设置初始值。

被选定为initial-value的参数,依照syntax描述符定义,必须可以正确地解析。因此,如果syntax描述符为<color>,那么初始值必须是一个有效的color值。

语法

@property --property-name {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}

@property --property-name {
  syntax: "<color>";
  inherits: true;
  initial-value: #c0ffee;
}

取值

对于设定的syntax,具有正确值的字符串。

形式定义

形式语法

实例

为 --my-color --*添加颜色值类型检测、设置默认值并且设置属性值不允许被继承。

使用 CSS @property 规则:

@property --my-color {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}

使用 JavaScript 中的 CSS.registerProperty函数:

window.CSS.registerProperty({
  name: "--my-color",
  syntax: "<color>",
  inherits: false,
  initialValue: "#c0ffee",
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。