Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

@function — función de valor CSS personalizada

La regla experimental @function define una función CSS parametrizada cuyo resultado puede sustituirse dentro del valor de una propiedad.

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

Sintaxis

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

@function --name(<parameters>) [returns <type>]? { ... } define una función cuyo nombre empieza por --. Cada parámetro tiene nombre de propiedad personalizada, tipo y valor predeterminado opcionales. El descriptor result devuelve el valor; sin él se obtiene el valor garantizado no válido. El tipo de retorno valida result.

La llamada --name(arguments) se admite donde se admite var() y se evalúa al calcular valores. Los parámetros ocultan propiedades personalizadas homónimas y las variables locales ocultan parámetros. Ciclos, argumentos sobrantes, fallos de tipo o valores obligatorios ausentes invalidan la sustitución y pueden invalidar la propiedad completa.

Los nombres tienen ámbito de árbol; entre definiciones gana la capa de cascada más fuerte y luego la regla posterior. Es un borrador CSSWG y requiere comprobar compatibilidad. El ejemplo define --double() tipada, convierte opacidad 0.3 en 0.6 y lee el valor calculado real.

Ejemplos

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

La regla experimental @function define una función CSS parametrizada cuyo resultado puede sustituirse dentro del valor de una propiedad.

Fuentes