CSSPropertyRule: initialValue-Eigenschaft

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 nullable Eigenschaft der CSSPropertyRule-Schnittstelle gibt den Anfangswert der benutzerdefinierten Eigenschaftsregistrierung zurück, die durch die @property-Regel repräsentiert wird, und steuert den Anfangswert der Eigenschaft.

Wert

Ein String, der ein <declaration-value> ist.

Beispiele

Dieses Stylesheet enthält eine einzelne @property-Regel. Die erste zurückgegebene CSSRule wird eine CSSPropertyRule sein, die diese Regel darstellt. Die initialValue-Eigenschaft gibt den String "#c0ffee" zurück, was dem Wert der initial-value-Eigenschaft im CSS entspricht.

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