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 CSS Deskriptor ist erforderlich, wenn der @property At-Regel verwendet wird, es sei denn, die Syntax akzeptiert jeden gültigen Token-Stream. Er legt den Anfangswert für die Eigenschaft fest.

Der gewählte Wert als initial-value muss gemäß der Syntaxdefinition korrekt geparst werden. Wenn die Syntax also <color> ist, muss der initiale Wert ein gültiger color-Wert sein.

Syntax

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

@property --property-name {
  syntax: "<color>";
  inherits: true;
  initial-value: #c0ffee;
}

Werte

Ein String mit einem Wert, der ein korrekter Wert für die gewählte syntax ist.

Formale Definition

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

Formale Syntax

initial-value = 
  <declaration-value>?

Beispiele

Fügen Sie der --my-color benutzerdefinierten Eigenschaft einen Typüberprüfung hinzu, als Farbe, wobei der Anfangswert eine gültige Farbe ist:

Verwendung der CSS @property At-Regel:

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