Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

inherits

Baseline 2024
Newly available

Depuis ⁨July 2024⁩, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

Le descripteur CSS inherits de la règle @ @property contrôle si la propriété personnalisée CSS enregistrée hérite ou non de sa valeur par défaut. Ce descripteur est obligatoire : s'il est absent ou invalide, la règle @property entière est ignorée.

Syntaxe

css
/* La propriété personnalisée n'hérite pas de la valeur */
inherits: false;

/* La propriété personnalisée hérite de la valeur */
inherits: true;

Valeurs

true

La propriété hérite par défaut.

false

La propriété n'hérite pas par défaut.

Définition formelle

En lien avec les règles @@property
Valeur initialeauto
Valeur calculéecomme spécifié

Syntaxe formelle

inherits = 
true |
false

Exemples

Définir le comportement d'héritage d'une propriété personnalisée

Cet exemple montre comment définir une propriété personnalisée --my-color qui n'hérite pas sa valeur des éléments parents :

css
@property --my-color {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}

En utilisant JavaScript CSS.registerProperty() :

js
window.CSS.registerProperty({
  name: "--my-color",
  syntax: "<color>",
  inherits: false,
  initialValue: "#c0ffee",
});

Spécifications

Specification
CSS Properties and Values API Level 1
# inherits-descriptor

Compatibilité des navigateurs

Voir aussi