CKTIS / CSS
@function — fonction de valeur CSS personnalisée
La règle expérimentale @function définit une fonction CSS paramétrée dont le résultat peut être substitué dans une valeur de propriété.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
@function <prelude> { <rule-list> }@function --name(<parameters>) [returns <type>]? { ... } définit une fonction dont le nom commence par --. Chaque paramètre possède un nom de propriété personnalisée, un type et une valeur par défaut facultatifs. Le descripteur result fournit le retour ; sans lui, la valeur est garantie invalide. Le type de retour valide result.
L’appel --name(arguments) est permis là où var() l’est et s’évalue au calcul de la valeur. Les paramètres masquent les propriétés personnalisées homonymes et les variables locales masquent les paramètres. Cycle, arguments en trop, erreur de type ou valeur obligatoire absente invalident la substitution et peuvent invalider toute la propriété.
Les noms sont limités à l’arbre ; entre définitions, la couche de cascade la plus forte gagne, puis la règle la plus tardive. Ce brouillon CSSWG exige un test de compatibilité. L’exemple définit --double() typée, transforme l’opacité 0.3 en 0.6 et lit la valeur calculée réelle.
Exemples
const style = document.createElement('style');
style.textContent = `@function --double(--value <number>) returns <number> { result: calc(var(--value) * 2); }
.probe { opacity: --double(0.3); }`;
document.head.append(style);
const probe = document.createElement('div');
probe.className = 'probe';
probe.textContent = 'CKTIS';
document.body.append(probe);
const rule = style.sheet.cssRules[0];
console.log('rules=' + style.sheet.cssRules.length + '; first=' + rule.constructor.name + '; opacity=' + getComputedStyle(probe).opacity);Résultat
rules=2; first=CSSFunctionRule; opacity=0.6
La règle expérimentale @function définit une fonction CSS paramétrée dont le résultat peut être substitué dans une valeur de propriété.