CSS Properties and Values API
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 CSS Properties and Values API — Teil des CSS Houdini API-Pakets — erlaubt es Entwicklern, ihre CSS Custom Properties explizit zu definieren und ermöglicht damit Typüberprüfungen von Eigenschaften, Standardwerte und die Option, ob Eigenschaften ihren Wert erben oder nicht.
Schnittstellen
CSS.registerProperty-
Definiert, wie ein Browser CSS Custom Properties parsen soll. Diese Schnittstelle kann über
CSS.registerPropertyin JavaScript aufgerufen werden. @property-
Definiert, wie ein Browser CSS Custom Properties parsen soll. Diese Schnittstelle kann über
@propertyAt-Regel in CSS aufgerufen werden.
Beispiele
Das folgende Beispiel registriert eine Custom Property mit dem Namen --my-color unter Verwendung von CSS.registerProperty in JavaScript. --my-color wird die CSS-Farbsyntax verwenden, einen Standardwert von #c0ffee haben und seinen Wert nicht erben:
window.CSS.registerProperty({
name: "--my-color",
syntax: "<color>",
inherits: false,
initialValue: "#c0ffee",
});
Die gleiche Registrierung kann in CSS unter Verwendung der @property At-Regel erfolgen:
@property --my-color {
syntax: "<color>";
inherits: false;
initial-value: #c0ffee;
}
Spezifikationen
| Specification |
|---|
| CSS Properties and Values API Level 1 # the-css-property-rule-interface |
| CSS Properties and Values API Level 1 # the-registerproperty-function |