WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

CSS Custom Properties und Themes

Custom Properties speichern Werte, die von var() verwendet werden. Kaskade und Vererbung ermöglichen gemeinsame Design-Tokens und lokale Überschreibungen, etwa für ein dunkles Theme.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

--token: value;
property: var(--token);
property: var(--token, fallback);

Eine Custom Property hat einen Namen, der mit -- beginnt, zum Beispiel --ink. Bei Namen wird zwischen Groß- und Kleinschreibung unterschieden: --ink und --Ink sind verschieden. var(--ink) setzt ihren Wert in den Wert einer anderen Eigenschaft ein; dadurch entstehen weder Selektoren noch Eigenschaftsnamen.

Nicht registrierte Custom Properties nehmen an der Kaskade teil und werden vererbt. Lege gemeinsame Tokens in :root und Theme-Überschreibungen auf einem Container fest. Nachfahren erben die überschriebenen Werte, sofern sie keine eigenen Deklarationen haben. Im Beispiel ändert .dark die Tokens, während die .card-Regel gemeinsam bleibt.

var(--space, 16px) verwendet den Ersatzwert, wenn das Token fehlt oder den garantiert ungültigen Wert hat, zum Beispiel aufgrund eines Abhängigkeitszyklus. Die Funktion prüft nicht, ob ein vorhandenes Token zur Zieleigenschaft passt: --ink: 16px aktiviert den Ersatzwert in color: var(--ink, black) nicht. Die Deklaration wird zum Zeitpunkt der berechneten Werte ungültig; bei color bedeutet das Vererbung und nicht die Rückkehr zu einer früheren Deklaration in der Kaskade.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Custom properties</title>
<style>
  :root {
    --surface: white;
    --ink: black;
  }
  .dark {
    --surface: black;
    --ink: white;
  }
  .card {
    background-color: var(--surface);
    color: var(--ink);
    padding: var(--space, 16px);
  }
</style>
<div class="card">Light</div>
<section class="dark">
  <div class="card">Dark</div>
</section>
</html>

Ergebnis

Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen