initial-value

Baseline 2024

新推出

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

@property at-rule 的 initial-value 描述符指定了注册 CSS 自定义属性的初始值。它是一个必需的描述符，除非 syntax 描述符的值是通用语法 (*)。如果必需但缺失或无效，则整个 @property 规则无效并被忽略。

语法

css

/* Set initial color value */
initial-value: rebeccapurple;

/* Set initial length value */
initial-value: 2rem;

一个与 syntax 描述符中指定的类型匹配的值。例如，如果 syntax 是 <color>，那么 initial-value 必须是一个有效的 color 值。

initial-value = 
  <declaration-value>?

此示例演示如何定义一个自定义属性 --my-color，其初始颜色值为 #c0ffee。当属性未继承 (inherits: false) 并且元素上未设置其他值时，将使用此初始值。

css

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

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

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

本页面最后由 MDN 贡献者于 2025 年 7 月 14 日修改。