initial-value

基线 2024

最新可用

自 2024 年 7 月起，此功能可在最新的设备和浏览器版本中使用。此功能可能在较旧的设备或浏览器中无法使用。

当使用 @property at-rule 时，需要 initial-value CSS 描述符，除非语法接受任何有效的标记流。它设置属性的初始值。

作为 initial-value 选择的值必须根据语法定义正确解析。因此，如果语法是 <color>，则 initial-value 必须是有效的 color 值。

语法

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

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

值

一个字符串，其值为所选 syntax 的正确值。

正式定义

相关 at-rule@property
初始值n/a（必需）
计算值按指定

正式语法

initial-value = 
  <declaration-value>?

示例

将类型检查添加到 --my-color 自定义属性，作为颜色，初始值为有效颜色

使用 CSS @property at-rule

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",
});

规范

规范
CSS 属性和值 API 级别 1
# initial-value-descriptor

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅