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

CKTIS / CSS

inherit() : fonction en projet pour une propriété personnalisée du parent

Distinguez inherit(), encore expérimental, du mot-clé inherit et de var().

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

Syntaxe

margin-left: inherit(--space, 5px);

La fonction inherit() proposée lit la valeur calculée héritée d’une propriété personnalisée nommée. Elle est utile lorsque l’enfant déclare lui-même cette propriété : var(--space) lit sa valeur courante, tandis que inherit(--space) est destiné à accéder à la valeur héritée. Cette syntaxe diffère du mot-clé inherit ordinaire, qui demande l’héritage de la propriété à laquelle on affecte une valeur.

Le projet actuel accepte les noms de propriétés personnalisées comme --space, avec une valeur de repli facultative si la valeur héritée est absente ou invalide. Il ne permet pas de lire librement les propriétés standard du parent, comme width. Lire une valeur calculée ne signifie pas non plus obtenir les dimensions finales utilisées en pixels. Cette syntaxe étant expérimentale, conservez une solution fonctionnelle.

Dans l’exemple, le parent déclare --space: 12px et l’enfant la remplace par 30px. Chromium 157 rejette la déclaration inherit() testée : la marge précédente de 7px reste donc appliquée, tandis que var(--space) donne 30px. Le cas de propriété absente conserve aussi 7px parce que toute la déclaration non prise en charge est rejetée, et non parce que la fonction aurait choisi ce repli.

Exemples

const parent=document.createElement('div');parent.style.setProperty('--space','12px');
const child=document.createElement('div');child.style.setProperty('--space','30px');child.style.marginLeft='7px';
child.style.marginLeft='inherit(--space, 5px)';parent.append(child);document.body.append(parent);
const fromParent=getComputedStyle(child).marginLeft;
child.style.marginLeft='var(--space)';const fromSelf=getComputedStyle(child).marginLeft;
child.style.marginLeft='7px';child.style.marginLeft='inherit(--missing, 5px)';
console.log('supported='+CSS.supports('margin-left','inherit(--space, 5px)')+'; parent='+fromParent+'; self='+fromSelf+'; missing='+getComputedStyle(child).marginLeft+'; standard-property='+CSS.supports('width','inherit(width)'));

Résultat

supported=false; parent=7px; self=30px; missing=7px; standard-property=false

Ne prenez pas les résultats de 7px pour un héritage réussi. Le test de prise en charge vaut false ; l’exemple montre un repli sûr dans ce navigateur.

Sources