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.