CKTIS / CSS
@property — enregistrement typé d’une propriété personnalisée
La règle @property enregistre une propriété personnalisée avec type de valeur, héritage et valeur initiale.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
@property <custom-property-name># {
<declaration-list>
} | @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;La forme bloc @property <custom-property-name># { <declaration-list> } peut enregistrer un nom ou une liste de noms séparés par des virgules. Le descripteur syntax vaut par défaut *, inherits active par défaut l’héritage et l’absence de initial-value conserve la valeur initiale garantie invalide. La spécification admet aussi la forme instruction abrégée @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, qui garde toujours l’héritage par défaut.
Le type enregistré est contrôlé au calcul de la valeur, pas lors de l’analyse initiale de la déclaration. Une valeur initiale fournie doit respecter la grammaire ; les descripteurs inconnus sont ignorés. Si plusieurs règles enregistrent le même nom, la dernière règle valide dans l’ordre de la feuille gagne, tandis qu’un enregistrement par CSS.registerProperty() les précède tous.
L’enregistrement permet une interpolation réelle des nombres, couleurs ou longueurs et définit l’héritage d’une API de composant. L’exemple enregistre --tone comme <color> sans héritage. La valeur incompatible 10px passe l’analyse de déclaration mais échoue au calcul ; l’enfant reçoit donc le vert initial, alors qu’un bleu valide reste bleu. L’objet CSSPropertyRule confirme le nom et l’indicateur d’héritage.
Exemples
const style = document.createElement('style');
style.textContent = `@property --tone { syntax: "<color>"; inherits: false; initial-value: rgb(0 128 0); }
.parent { --tone: red; }
.invalid { --tone: 10px; color: var(--tone); }
.valid { --tone: blue; color: var(--tone); }`;
document.head.append(style);
const parent = document.createElement('div');
parent.className = 'parent';
parent.innerHTML = '<span class="invalid">invalid</span><span class="valid">valid</span>';
document.body.append(parent);
const invalid = getComputedStyle(parent.children[0]);
const valid = getComputedStyle(parent.children[1]);
const rule = style.sheet.cssRules[0];
console.log('rule=' + rule.constructor.name + '; name=' + rule.name + '; invalid=' + invalid.getPropertyValue('--tone').trim() + '; valid=' + valid.getPropertyValue('--tone').trim() + '; inherits=' + rule.inherits);Résultat
rule=CSSPropertyRule; name=--tone; invalid=rgb(0, 128, 0); valid=rgb(0, 0, 255); inherits=false
La règle @property enregistre une propriété personnalisée avec type de valeur, héritage et valeur initiale.