Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

@function — własna funkcja wartości CSS

Eksperymentalna reguła @function definiuje parametryzowaną funkcję CSS, której wynik może zostać podstawiony w wartości właściwości.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

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

@function --name(<parameters>) [returns <type>]? { ... } definiuje funkcję o nazwie zaczynającej się od --. Każdy parametr ma nazwę własnej właściwości, opcjonalny typ i opcjonalną wartość domyślną. Deskryptor result zwraca wartość; bez niego funkcja zwraca gwarantowanie niepoprawną wartość. Typ wyniku sprawdza result przed podstawieniem.

Wywołanie --name(arguments) jest dozwolone tam, gdzie wolno użyć var(), i jest oceniane dopiero przy obliczaniu wartości. Parametry przesłaniają własne właściwości o tych samych nazwach, a zmienne lokalne z ciała przesłaniają parametry. Cykle, nadmiar argumentów, błędny typ lub brak wymaganej wartości unieważniają podstawienie i mogą unieważnić całą właściwość w czasie obliczania.

Nazwy funkcji są ograniczone do drzewa; przy kilku definicjach wygrywa silniejsza warstwa kaskady, a w tej samej warstwie późniejsza reguła. To szkic CSSWG, więc obsługę trzeba sprawdzić w docelowych przeglądarkach. Przykład definiuje typowaną --double(), oblicza opacity z 0.3 na 0.6 i odczytuje rzeczywistą wartość obliczoną.

Przykłady

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

Wynik

rules=2; first=CSSFunctionRule; opacity=0.6

Eksperymentalna reguła @function definiuje parametryzowaną funkcję CSS, której wynik może zostać podstawiony w wartości właściwości.

Źródła