initial-value

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.

Der initial-value Deskriptor der @property At-Regel legt den Anfangswert für die registrierte CSS-Custom-Property fest. Er ist ein erforderlicher Deskriptor, es sei denn, der Wert des Deskriptors syntax ist die universelle Syntax (*). Wenn er erforderlich ist, aber fehlt oder ungültig ist, ist die gesamte @property Regel ungültig und wird ignoriert.

Syntax

css
/* Set initial color value */
initial-value: rebeccapurple;

/* Set initial length value */
initial-value: 2rem;

Werte

Ein Wert, der dem im Deskriptor syntax angegebenen Typ entspricht. Wenn beispielsweise syntax <color> ist, muss der initial-value ein gültiger color Wert sein.

Formale Definition

Zugehörige @-Regel@property
Initialer Wertn/a (required)
Berechneter Wertwie angegeben

Formale Syntax

initial-value = 
  <declaration-value>?

Beispiele

Festlegen eines Anfangswerts für eine benutzerdefinierte Eigenschaft

Dieses Beispiel zeigt, wie eine benutzerdefinierte Eigenschaft --my-color mit einem anfänglichen Farbwert von #c0ffee definiert wird. Dieser Anfangswert wird verwendet, wenn die Eigenschaft nicht vererbt wird (inherits: false) und kein anderer Wert am Element gesetzt ist.

css
@property --my-color {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}

Verwendung von JavaScript CSS.registerProperty():

js
window.CSS.registerProperty({
  name: "--my-color",
  syntax: "<color>",
  inherits: false,
  initialValue: "#c0ffee",
});

Spezifikationen

Specification
CSS Properties and Values API Level 1
# initial-value-descriptor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch