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

CKTIS / CSS

Propriétés personnalisées CSS : --*

Les propriétés personnalisées stockent des valeurs sous des noms commençant par --. Elles participent à la cascade, sont héritées par défaut et permettent à var() d’insérer leurs valeurs dans les déclarations d’autres propriétés.

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

Syntaxe

--name: <declaration-value>?;
property: var(--name, fallback);

--* désigne la famille des propriétés personnalisées, et non un nom de déclaration littéral. Utilisez un identifiant valide commençant par --, comme --size ; -- seul est réservé. La casse est prise en compte : --size et --Size sont des propriétés différentes.

Les propriétés personnalisées non enregistrées participent à la cascade et sont héritées. Elles stockent des jetons CSS, qui ne constituent pas nécessairement une valeur valide pour la propriété qui les utilise. var(--size, 20px) remplace l’expression par la valeur de --size ; la valeur de repli s’applique lorsque cette propriété a la valeur garantie invalide, y compris lorsqu’aucune déclaration ne la définit. Elle ne corrige pas une valeur existante qui ne convient pas à la propriété utilisatrice : --size: red ne déclenchera pas la valeur de repli pour width.

La valeur initiale d’une propriété non enregistrée est garantie invalide ; initial la rétablit. En revanche, la déclaration vide --size:; est une valeur vide valide. Les références cycliques produisent des valeurs invalides. Dans l’exemple, le premier rectangle hérite de 40px, tandis que le second utilise la valeur de repli 20px après l’application de initial.

Exemples

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

Résultat

.box: width = 40px
.box.reset: width = 20px

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