initial-value
Baseline 2024Newly 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 gibt den Initialwert für die registrierte CSS-Custom-Property an.
Es handelt sich um einen erforderlichen Deskriptor, es sei denn, der Wert des syntax
Deskriptors ist die universelle Syntax (*
).
Falls erforderlich, aber fehlend oder ungültig, wird die gesamte @property
-Regel als ungültig betrachtet und ignoriert.
Syntax
/* Set initial color value */
initial-value: rebeccapurple;
/* Set initial length value */
initial-value: 2rem;
Werte
Formale Definition
Zugehörige @-Regel | @property |
---|---|
Anfangswert | n/a (required) |
Berechneter Wert | wie angegeben |
Formale Syntax
initial-value =
<declaration-value>?
Beispiele
Festlegen eines Initialwerts für eine benutzerdefinierte Eigenschaft
Dieses Beispiel zeigt, wie eine benutzerdefinierte Eigenschaft --my-color
mit einem anfänglichen Farbwert von #c0ffee
definiert wird. Dieser Initialwert 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
Specification |
---|
CSS Properties and Values API Level 1 # initial-value-descriptor |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
initial-value descriptor |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
Siehe auch
- Andere
@property
Deskriptoren:inherits
undsyntax
- CSS Properties and Values API
- CSS Painting API
- CSS Typed Object Model
- Houdini APIs