CKTIS / CSS
@function — funzione di valore CSS personalizzata
La regola sperimentale @function definisce una funzione CSS parametrica il cui risultato può essere sostituito nel valore di una proprietà.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
@function <prelude> { <rule-list> }@function --name(<parameters>) [returns <type>]? { ... } definisce una funzione con nome che inizia per --. Ogni parametro ha nome di proprietà personalizzata, tipo e valore predefinito facoltativi. Il descrittore result restituisce il valore; senza di esso si ottiene il valore garantito non valido. Il tipo di ritorno convalida result.
La chiamata --name(arguments) è ammessa dove è ammesso var() e viene valutata al calcolo del valore. I parametri oscurano proprietà omonime e le variabili locali oscurano i parametri. Cicli, troppi argomenti, errori di tipo o valori mancanti invalidano la sostituzione e possono invalidare l’intera proprietà.
I nomi hanno ambito d’albero; tra definizioni vince il livello di cascata più forte, poi la regola successiva. È una bozza CSSWG e richiede verifica nei browser. L’esempio definisce --double() tipizzata, porta l’opacità da 0.3 a 0.6 e legge il valore calcolato.
Esempi
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);Risultato
rules=2; first=CSSFunctionRule; opacity=0.6
La regola sperimentale @function definisce una funzione CSS parametrica il cui risultato può essere sostituito nel valore di una proprietà.