CKTIS / CSS
@property — registro tipado de una propiedad personalizada
La regla @property registra una propiedad personalizada con tipo de valor, herencia y valor inicial.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
@property <custom-property-name># {
<declaration-list>
} | @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;La forma de bloque @property <custom-property-name># { <declaration-list> } puede registrar un nombre o una lista separada por comas. El descriptor syntax tiene como valor inicial *, inherits activa la herencia de forma predeterminada y omitir initial-value conserva el valor inicial garantizado como no válido. La especificación también admite la sentencia abreviada @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, que siempre mantiene la herencia predeterminada.
El tipo registrado se comprueba al calcular el valor, no durante el análisis inicial de la declaración. Un valor inicial indicado debe cumplir la gramática; los descriptores desconocidos se ignoran. Si varias reglas registran el mismo nombre, vence la última regla válida según el orden de la hoja, mientras que un registro mediante CSS.registerProperty() tiene prioridad sobre todas.
El registro permite interpolar números, colores o longitudes y decidir la herencia de una API de componente. El ejemplo registra --tone como <color> sin herencia. El valor incompatible 10px supera el análisis de declaración pero falla al calcularse, por lo que el hijo recibe el verde inicial; un azul válido permanece azul. El objeto CSSPropertyRule confirma el nombre y la marca de herencia.
Ejemplos
const style = document.createElement('style');
style.textContent = `@property --tone { syntax: "<color>"; inherits: false; initial-value: rgb(0 128 0); }
.parent { --tone: red; }
.invalid { --tone: 10px; color: var(--tone); }
.valid { --tone: blue; color: var(--tone); }`;
document.head.append(style);
const parent = document.createElement('div');
parent.className = 'parent';
parent.innerHTML = '<span class="invalid">invalid</span><span class="valid">valid</span>';
document.body.append(parent);
const invalid = getComputedStyle(parent.children[0]);
const valid = getComputedStyle(parent.children[1]);
const rule = style.sheet.cssRules[0];
console.log('rule=' + rule.constructor.name + '; name=' + rule.name + '; invalid=' + invalid.getPropertyValue('--tone').trim() + '; valid=' + valid.getPropertyValue('--tone').trim() + '; inherits=' + rule.inherits);Resultado
rule=CSSPropertyRule; name=--tone; invalid=rgb(0, 128, 0); valid=rgb(0, 0, 255); inherits=false
La regla @property registra una propiedad personalizada con tipo de valor, herencia y valor inicial.