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 日修改。