Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

Propriétés personnalisées CSS et thèmes

Les propriétés personnalisées stockent des valeurs utilisées par var(). La cascade et l’héritage permettent de partager des jetons de conception et de les remplacer localement, par exemple pour créer un thème sombre.

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

Syntaxe

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

Une propriété personnalisée porte un nom commençant par --, comme --ink. Les noms sont sensibles à la casse : --ink et --Ink sont différents. var(--ink) insère sa valeur dans celle d’une autre propriété ; cela ne crée ni sélecteurs ni noms de propriétés.

Les propriétés personnalisées non enregistrées participent à la cascade et sont héritées. Placez les jetons partagés sur :root et les remplacements de thème sur un conteneur. Les descendants héritent des valeurs remplacées, sauf s’ils ont leurs propres déclarations. Dans l’exemple, .dark modifie les jetons tandis que la règle .card reste commune.

var(--space, 16px) utilise sa valeur de secours lorsque le jeton est absent ou a la valeur garantie comme invalide, par exemple à cause d’un cycle de dépendance. Cette fonction ne vérifie pas si un jeton existant convient à la propriété de destination : --ink: 16px n’activera pas la valeur de secours dans color: var(--ink, black). La déclaration devient invalide au moment du calcul des valeurs ; pour color, cela signifie l’héritage, et non le retour à une déclaration antérieure dans la cascade.

Exemples

<!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>

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources