CSSPropertyRule: Eigenschaft initialValue

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.

Die schreibgeschützte initialValue-Eigenschaft der CSSPropertyRule-Schnittstelle gibt den anfänglichen Wert der benutzerdefinierten Eigenschaftsregistrierung zurück, die durch die @property-Regel dargestellt wird, und steuert den anfänglichen Wert der Eigenschaft.

Wert

Ein String, der ein <declaration-value> ist, wie in CSS Syntax 3 definiert.

Beispiele

Dieses Stylesheet enthält eine einzige @property-Regel. Die erste zurückgegebene CSSRule wird eine CSSPropertyRule sein, die diese Regel repräsentiert. Die initialValue-Eigenschaft gibt den String "#c0ffee" zurück, da dies der Wert der initial-value-Eigenschaft im CSS ist.

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

Spezifikationen

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

Browser-Kompatibilität