初始值
Baseline 2024
Newly available
Since July 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
initial-value
CSS描述符在使用@property
at-rule
的时候是必需的,除非 syntax 属性接受了任何有效的 token 流。它为属性设置初始值。
被选定为initial-value
的参数,依照syntax
描述符定义,必须可以正确地解析。因此,如果syntax
描述符为<color>
,那么初始值必须是一个有效的color
值。
语法
css
@property --property-name {
syntax: "<color>";
inherits: false;
initial-value: #c0ffee;
}
@property --property-name {
syntax: "<color>";
inherits: true;
initial-value: #c0ffee;
}
取值
对于设定的syntax
,具有正确值的字符串。
形式定义
形式语法
initial-value =
<declaration-value>?
实例
为 --my-color
自定义属性
添加颜色值类型检测、设置默认值并且设置属性值不允许被继承。
css
@property --my-color {
syntax: "<color>";
inherits: false;
initial-value: #c0ffee;
}
使用 JavaScript 中的 CSS.registerProperty
函数:
js
window.CSS.registerProperty({
name: "--my-color",
syntax: "<color>",
inherits: false,
initialValue: "#c0ffee",
});
规范
Specification |
---|
CSS Properties and Values API Level 1 # initial-value-descriptor |
浏览器兼容性
BCD tables only load in the browser