CKTIS / CSS
Aangepaste CSS-eigenschappen: --*
Aangepaste eigenschappen slaan waarden op onder namen die beginnen met --. Ze doen mee aan de cascade, worden standaard overgeërfd en laten var() hun waarden invoegen in declaraties van andere eigenschappen.
Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
--name: <declaration-value>?;
property: var(--name, fallback);--* staat voor de familie van aangepaste eigenschappen, niet voor een letterlijke declaratienaam. Gebruik een geldige identifier die begint met --, zoals --size; alleen -- is gereserveerd. Hoofdletters en kleine letters zijn verschillend: --size en --Size zijn verschillende eigenschappen.
Niet-geregistreerde aangepaste eigenschappen doen mee aan de cascade en worden overgeërfd. Ze slaan CSS-tokens op, die niet noodzakelijk een geldige waarde zijn voor de eigenschap die ze gebruikt. var(--size, 20px) vervangt de expressie door de waarde van --size; de terugvalwaarde geldt wanneer die eigenschap de gegarandeerd ongeldige waarde heeft, ook als er geen declaratie is die een waarde opgeeft. De terugvalwaarde herstelt geen bestaande waarde die niet geschikt is voor de gebruikende eigenschap: --size: red activeert de terugvalwaarde voor width niet.
De beginwaarde van een niet-geregistreerde eigenschap is gegarandeerd ongeldig; initial herstelt die waarde. De lege declaratie --size:; is daarentegen een geldige lege waarde. Cyclische verwijzingen leveren ongeldige waarden op. In het voorbeeld erft de eerste rechthoek 40px, terwijl de tweede na toepassing van initial de terugvalwaarde 20px gebruikt.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>Custom property inheritance</title>
<style>
.group { --size: 40px; }
.box {
width: var(--size, 20px);
height: 20px;
background: black;
margin-bottom: 4px;
}
.reset { --size: initial; }
</style>
<div class="group">
<div class="box"></div>
<div class="box reset"></div>
</div>Resultaat
.box: width = 40px .box.reset: width = 20px
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.