CKTIS / CSS
@property — typovaná registrácia vlastnej vlastnosti
Pravidlo @property registruje vlastnú vlastnosť s typom hodnoty, správaním dedenia a počiatočnou hodnotou.
Verzia: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
@property <custom-property-name># {
<declaration-list>
} | @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;Bloková podoba @property <custom-property-name># { <declaration-list> } môže registrovať jeden názov alebo zoznam oddelený čiarkami. Deskriptor syntax má predvolenú hodnotu *, inherits predvolene zapína dedenie a vynechaný initial-value ponechá zaručene neplatnú počiatočnú hodnotu. Špecifikácia pripúšťa aj skrátený príkaz @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, ktorý vždy zachová predvolené dedenie.
Registrovaný typ sa kontroluje pri výpočte hodnoty, nie pri prvom spracovaní deklarácie. Zadaná počiatočná hodnota musí zodpovedať gramatike; neznáme deskriptory sa ignorujú. Ak rovnaký názov registruje viac pravidiel, vyhrá posledné platné podľa poradia štýlu, kým registrácia cez CSS.registerProperty() má pred všetkými pravidlami prednosť.
Registrácia umožňuje zmysluplnú interpoláciu čísel, farieb či dĺžok a určuje dedenie API komponentu. Príklad registruje --tone ako <color> bez dedenia. Nezodpovedajúce 10px prejde parserom deklarácie, ale zlyhá pri výpočte, takže potomok dostane zelenú počiatočnú hodnotu; platná modrá zostane modrá. Objekt CSSPropertyRule potvrdzuje názov a príznak dedenia.
Príklady
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);Výsledok
rule=CSSPropertyRule; name=--tone; invalid=rgb(0, 128, 0); valid=rgb(0, 0, 255); inherits=false
Pravidlo @property registruje vlastnú vlastnosť s typom hodnoty, správaním dedenia a počiatočnou hodnotou.