继承

基线 2024

新可用

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

当使用 @property At规则 时，需要 inherits CSS 描述符，它控制由 @property 指定的自定义属性注册是否默认继承。

语法

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

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

值

true

该属性默认继承。

false

该属性默认不继承。

正式定义

相关 At规则@property
初始值auto
计算值按指定

正式语法

inherits = 
  true   |
  false

示例

将类型检查添加到 --my-color 自定义属性，作为颜色、默认值，并且不允许它继承其值

使用 CSS @property At规则

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 级
# inherits-descriptor

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅