CKTIS / CSS
CSS-aangepaste eigenschappen en thema’s
Aangepaste eigenschappen slaan waarden op die door var() worden gebruikt. De cascade en overerving maken het mogelijk ontwerptokens te delen en lokaal te overschrijven, bijvoorbeeld voor een donker thema.
Versie: 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);Een aangepaste eigenschap heeft een naam die begint met --, zoals --ink. Namen zijn hoofdlettergevoelig: --ink en --Ink zijn verschillend. var(--ink) vervangt de waarde ervan in de waarde van een andere eigenschap; het maakt geen selectors of eigenschapsnamen aan.
Niet-geregistreerde aangepaste eigenschappen doen mee aan de cascade en worden overgeërfd. Zet gedeelde tokens op :root en thema-overschrijvingen op een container. Afstammelingen erven de overschreven waarden, tenzij ze eigen declaraties hebben. In het voorbeeld wijzigt .dark de tokens, terwijl de regel .card gedeeld blijft.
var(--space, 16px) gebruikt de terugvalwaarde als de token ontbreekt of de gegarandeerd ongeldige waarde heeft, bijvoorbeeld door een afhankelijkheidscyclus. De functie controleert niet of een bestaande token geschikt is voor de doeleigenschap: --ink: 16px activeert de terugvalwaarde in color: var(--ink, black) niet. De declaratie wordt ongeldig op het moment waarop de waarden worden berekend; voor color betekent dit overerving, niet terugvallen op een eerdere declaratie in de cascade.
Voorbeelden
<!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>Resultaat
Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.