CKTIS / CSS
@property — registrazione tipizzata di una proprietà personalizzata
La regola @property registra una proprietà personalizzata con tipo di valore, ereditarietà e valore iniziale.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
@property <custom-property-name># {
<declaration-list>
} | @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;La forma a blocco @property <custom-property-name># { <declaration-list> } può registrare un nome o un elenco separato da virgole. Il descrittore syntax ha valore predefinito *, inherits abilita l’ereditarietà per impostazione predefinita e l’assenza di initial-value lascia il valore iniziale garantito non valido. La specifica ammette anche l’istruzione abbreviata @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, che conserva sempre l’ereditarietà predefinita.
Il tipo registrato viene controllato al calcolo del valore, non durante l’analisi iniziale della dichiarazione. Un valore iniziale fornito deve rispettare la grammatica; i descrittori sconosciuti sono ignorati. Se più regole registrano lo stesso nome, vince l’ultima regola valida nell’ordine del foglio, mentre una registrazione tramite CSS.registerProperty() ha precedenza su tutte.
La registrazione consente di interpolare numeri, colori o lunghezze e di definire l’ereditarietà di un’API di componente. L’esempio registra --tone come <color> senza ereditarietà. Il valore incompatibile 10px supera l’analisi della dichiarazione ma fallisce al calcolo, quindi il figlio riceve il verde iniziale; un blu valido resta blu. L’oggetto CSSPropertyRule conferma nome e flag di ereditarietà.
Esempi
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);Risultato
rule=CSSPropertyRule; name=--tone; invalid=rgb(0, 128, 0); valid=rgb(0, 0, 255); inherits=false
La regola @property registra una proprietà personalizzata con tipo di valore, ereditarietà e valore iniziale.