Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Custom properties (--*): CSS variables

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨April 2017⁩.

Eigenschaftsnamen, die mit -- beginnen, wie --example-name, repräsentieren benutzerdefinierte Eigenschaften, die einen Wert enthalten, der in anderen Deklarationen mit der var()-Funktion verwendet werden kann.

Benutzerdefinierte Eigenschaften sind auf das/die Element(e) beschränkt, auf denen sie deklariert wurden, und nehmen an der Kaskade teil: Der Wert einer solchen benutzerdefinierten Eigenschaft ist derjenige aus der Deklaration, die durch den Kaskadenalgorithmus entschieden wurde.

Anfangswertsiehe Text
Anwendbar aufalle Elemente
VererbtJa
Berechneter Wertwie angegeben, wobei Variablen ersetzt werden
Animationstypdiskret

Syntax

css
--some-keyword: left;
--some-color: #123456;
--some-complex-value: 3px 6px rgb(20 32 54);
<declaration-value>

Dieser Wert entspricht jeder Sequenz von einem oder mehreren Token, solange die Sequenz kein unzulässiges Token enthält. Er repräsentiert die Gesamtheit dessen, was eine gültige Deklaration als Wert haben kann.

Hinweis: Namen benutzerdefinierter Eigenschaften sind case-sensitiv — --my-color wird als separate benutzerdefinierte Eigenschaft zu --My-color behandelt.

Beispiel

HTML

html
<p id="firstParagraph">
  This paragraph should have a blue background and yellow text.
</p>
<p id="secondParagraph">
  This paragraph should have a yellow background and blue text.
</p>
<div id="container">
  <p id="thirdParagraph">
    This paragraph should have a green background and yellow text.
  </p>
</div>

CSS

css
:root {
  --first-color: #1166ff;
  --second-color: #ffff77;
}

#firstParagraph {
  background-color: var(--first-color);
  color: var(--second-color);
}

#secondParagraph {
  background-color: var(--second-color);
  color: var(--first-color);
}

#container {
  --first-color: #229900;
}

#thirdParagraph {
  background-color: var(--first-color);
  color: var(--second-color);
}

Ergebnis

Spezifikationen

Specification
CSS Custom Properties for Cascading Variables Module Level 1
# defining-variables

Browser-Kompatibilität

Siehe auch