CKTIS / CSS
@property — tipizirana registracija prilagođenog svojstva
Pravilo @property registrira prilagođeno svojstvo s vrstom vrijednosti, nasljeđivanjem i početnom vrijednošću.
Verzija: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaksa
@property <custom-property-name># {
<declaration-list>
} | @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;Blokovni oblik @property <custom-property-name># { <declaration-list> } može registrirati jedno ime ili popis odvojen zarezima. Deskriptor syntax ima zadanu vrijednost *, inherits zadano uključuje nasljeđivanje, a izostavljeni initial-value ostavlja zajamčeno nevaljanu početnu vrijednost. Specifikacija dopušta i skraćenu naredbu @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, koja uvijek zadržava zadano nasljeđivanje.
Registrirana vrsta provjerava se pri izračunatoj vrijednosti, ne tijekom početnog parsiranja deklaracije. Zadana početna vrijednost mora odgovarati gramatici; nepoznati deskriptori zanemaruju se. Ako više pravila registrira isto ime, pobjeđuje posljednje valjano prema redoslijedu lista, dok registracija putem CSS.registerProperty() ima prednost pred svim pravilima.
Registracija omogućuje smislenu interpolaciju brojeva, boja ili duljina i određuje nasljeđivanje API-ja komponente. Primjer registrira --tone kao <color> bez nasljeđivanja. Neodgovarajući 10px prolazi parser deklaracije, ali pada pri izračunu, pa dijete dobiva zelenu početnu vrijednost; valjana plava ostaje plava. Objekt CSSPropertyRule potvrđuje ime i oznaku nasljeđivanja.
Primjeri
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);Rezultat
rule=CSSPropertyRule; name=--tone; invalid=rgb(0, 128, 0); valid=rgb(0, 0, 255); inherits=false
Pravilo @property registrira prilagođeno svojstvo s vrstom vrijednosti, nasljeđivanjem i početnom vrijednošću.