initial-value

Syntax

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

/* Set initial length value */
initial-value: 16px;

Werte

Ein Wert, der dem Typ entspricht, der im syntax Deskriptor angegeben ist. Zum Beispiel, wenn syntax <color> ist, muss der initial-value ein gültiger color Wert sein.

Wenn der Wert des syntax Deskriptors nicht die universelle Syntaxdefinition ist, muss der initial-value Deskriptor einen rechnerisch unabhängigen Wert haben. Das bedeutet, dass der Wert in einen berechneten Wert umgewandelt werden kann, ohne dass er von anderen Werten abhängig ist, außer von "globalen" Definitionen, die unabhängig von CSS sind. Zum Beispiel, 10px ist rechnerisch unabhängig – es ändert sich nicht, wenn es in einen berechneten Wert umgewandelt wird. 2in ist ebenfalls gültig, weil 1in immer 96px entspricht. 3em ist jedoch nicht gültig, da der Wert eines em von der font-size des Elternteils abhängig ist.

Formale Definition

Formale Syntax

initial-value = 
  <declaration-value>?  

Beispiele

Einen Anfangswert für eine benutzerdefinierte Eigenschaft festlegen

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

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

Verwendung von JavaScript CSS.registerProperty():

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Andere @property Deskriptoren: inherits und syntax
• CSS Properties and Values API
• CSS Painting API
• CSS Typed Object Model
• Houdini APIs