Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

@function — função de valor CSS personalizada

A regra experimental @function define uma função CSS parametrizada cujo resultado pode ser substituído no valor de uma propriedade.

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

Sintaxe

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

@function --name(<parameters>) [returns <type>]? { ... } define uma função com nome iniciado por --. Cada parâmetro tem nome de propriedade personalizada, tipo e valor predefinido opcionais. O descritor result fornece o retorno; sem ele obtém-se o valor garantidamente inválido. O tipo de retorno valida result.

A chamada --name(arguments) é permitida onde var() é permitida e avaliada ao calcular valores. Parâmetros ocultam propriedades homónimas e variáveis locais ocultam parâmetros. Ciclos, argumentos a mais, falhas de tipo ou valores obrigatórios ausentes invalidam a substituição e podem invalidar a propriedade inteira.

Os nomes têm âmbito de árvore; entre definições vence a camada de cascata mais forte e depois a regra posterior. É um rascunho CSSWG e exige teste nos navegadores. O exemplo define --double() tipada, converte opacidade 0.3 em 0.6 e lê o valor calculado.

Exemplos

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

Resultado

rules=2; first=CSSFunctionRule; opacity=0.6

A regra experimental @function define uma função CSS parametrizada cujo resultado pode ser substituído no valor de uma propriedade.

Fontes