1. 面向开发者的 Web 技术
  2. CSS：层叠样式表
  3. CSS 参考
  4. At-rules
  5. @property
  6. 初始值

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

初始值

基线 2024
最近可用

自 July 2024 起，此特性已在最新浏览器中得到支持。但在较旧的设备或浏览器中可能无法运行。

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

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

形式定义

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

形式语法

initial-value = 
  <declaration-value>?

实例

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

使用 CSS @property 规则:

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 Properties and Values API Level 1
# initial-value-descriptor

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题