CKTIS / CSS
@function — eigene CSS-Wertfunktion
Die experimentelle Regel @function definiert eine parametrisierte CSS-Funktion, deren Ergebnis in Eigenschaftswerte eingesetzt werden kann.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
@function <prelude> { <rule-list> }@function --name(<parameters>) [returns <type>]? { ... } definiert eine Funktion mit einem Namen ab --. Jeder Parameter hat einen Custom-Property-Namen, optional einen Typ und Standardwert. Der Deskriptor result liefert den Rückgabewert; ohne ihn entsteht der garantiert ungültige Wert. Ein Rückgabetyp prüft result vor dem Einsetzen.
Ein Aufruf --name(arguments) ist dort erlaubt, wo var() erlaubt ist, und wird zur Berechnungszeit ausgewertet. Parameter überdecken gleichnamige Custom Properties, lokale Variablen wiederum Parameter. Zyklen, zu viele Argumente, Typfehler oder fehlende Pflichtwerte machen die Substitution und eventuell die gesamte Eigenschaft ungültig.
Funktionsnamen gelten im Baumkontext; bei mehrfacher Definition gewinnt die stärkere Kaskadenebene, dann die spätere Regel. Der CSSWG-Entwurf erfordert Browserprüfungen. Das Beispiel definiert typisiertes --double(), berechnet Opazität 0.3 zu 0.6 und liest den tatsächlichen berechneten Wert.
Beispiele
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);Ergebnis
rules=2; first=CSSFunctionRule; opacity=0.6
Die experimentelle Regel @function definiert eine parametrisierte CSS-Funktion, deren Ergebnis in Eigenschaftswerte eingesetzt werden kann.