初始值

Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

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，具有正确值的字符串。

标准定义

Related at-rule@property
初始值n/a (required)
计算值as specified

标准语法

initial-value =   <declaration-value>

实例

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

使用 CSS @property 规则:

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

使用 JavaScript 中的 CSS.registerProperty (en-US)函数：

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

标准语法

initial-value =   <declaration-value>

规范

Specification
CSS Properties and Values API Level 1
# initial-value-descriptor

浏览器兼容性

BCD tables only load in the browser

另见