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, nullable initialValue-Eigenschaft der CSSPropertyRule-Schnittstelle gibt den Initialwert der benutzerdefinierten Eigenschaftenregistrierung zurück, die durch die @property-Regel dargestellt wird und den anfänglichen Wert der Eigenschaft steuert.

Wert

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

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 in der CSS entspricht.

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser