inherits

Baseline 2024
新推出

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

inherits@property at-rule 的一个CSS描述符,它控制已注册的CSS自定义属性是否默认继承。它是一个必需的描述符;如果缺失或无效,则整个@property规则将无效并被忽略。

语法

css
/* Custom property does not inherit values */
inherits: false;

/* Custom property inherits values */
inherits: true;

true

该属性默认继承。

false

该属性默认不继承。

正式定义

相关的 at-rule@property
初始值auto
计算值同指定值

正式语法

inherits = 
true |
false

示例

设置自定义属性的继承行为

本例演示如何定义一个自定义属性--my-color,使其不从父元素继承其值。

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 Level 1
# inherits-描述符

浏览器兼容性

另见