Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje