Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori