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

Since ⁨July 2024⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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