База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

@function — персонализирана функция за CSS стойност

Експерименталното правило @function определя параметризирана CSS функция, чийто резултат може да се замести в стойност на свойство.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

@function <prelude> { <rule-list> }

@function --name(<parameters>) [returns <type>]? { ... } определя функция с име, започващо с --. Всеки параметър има име на персонализирано свойство и незадължителни тип и подразбираща се стойност. Дескрипторът result връща резултата; без него стойността е гарантирано невалидна. Връщаният тип проверява result.

Извикване --name(arguments) е позволено там, където е позволено var(), и се оценява при изчисляване на стойността. Параметрите засенчват едноименни свойства, а локалните променливи засенчват параметрите. Цикли, излишни аргументи, грешен тип или липсваща стойност обезсилват заместването и могат цялото свойство.

Имената са ограничени в дървото; между дефиниции печели по-силният каскаден слой, после по-късното правило. Това е проект на CSSWG и изисква тест за поддръжка. Примерът определя типизирана --double(), превръща opacity 0.3 в 0.6 и чете действителната изчислена стойност.

Примери

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

Резултат

rules=2; first=CSSFunctionRule; opacity=0.6

Експерименталното правило @function определя параметризирана CSS функция, чийто резултат може да се замести в стойност на свойство.

Източници