CSSPropertyRule: inherits property

Baseline 2024

Newly available

Since July 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

The read-only inherits property of the CSSPropertyRule interface returns the inherit flag of the custom property registration represented by the @property rule, a boolean describing whether or not the property inherits by default.

Value

A boolean.

Examples

This stylesheet contains a single @property rule. The first CSSRule returned will be a CSSPropertyRule representing this rule. The inherits property returns the boolean false, this being the value of the inherits property in the CSS.

css
@property --property-name {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}
js
let myRules = document.styleSheets[0].cssRules;
console.log(myRules[0].inherits); //returns false

Specifications

Specification
CSS Properties and Values API Level 1
# dom-csspropertyrule-inherits

Browser compatibility

BCD tables only load in the browser