Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

@function — vlastní hodnotová funkce CSS

Experimentální pravidlo @function definuje parametrizovanou funkci CSS, jejíž výsledek lze dosadit do hodnoty vlastnosti.

Verze: 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>]? { ... } definuje funkci s názvem od --. Každý parametr má název vlastní vlastnosti, volitelný typ a výchozí hodnotu. Deskriptor result vrací výsledek; bez něj vznikne zaručeně neplatná hodnota. Návratový typ kontroluje result.

Volání --name(arguments) je povoleno tam, kde var(), a vyhodnotí se při výpočtu hodnoty. Parametry překrývají stejnojmenné vlastní vlastnosti a lokální proměnné překrývají parametry. Cykly, nadbytečné argumenty, chybný typ nebo chybějící hodnota zneplatní dosazení a mohou zneplatnit celou vlastnost.

Názvy mají rozsah stromu; mezi definicemi vyhraje silnější vrstva kaskády a potom pozdější pravidlo. Jde o návrh CSSWG vyžadující test podpory. Příklad definuje typovanou --double(), změní krytí 0.3 na 0.6 a čte skutečnou vypočtenou hodnotu.

Příklady

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);

Výsledek

rules=2; first=CSSFunctionRule; opacity=0.6

Experimentální pravidlo @function definuje parametrizovanou funkci CSS, jejíž výsledek lze dosadit do hodnoty vlastnosti.

Zdroje