Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / CSS

@property — tipizirana registracija lastne lastnosti

Pravilo @property registrira lastno lastnost z vrsto vrednosti, dedovanjem in začetno vrednostjo.

Različica: 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>? ]? ;

Blokovna oblika @property <custom-property-name># { <declaration-list> } lahko registrira eno ime ali z vejicami ločen seznam. Deskriptor syntax ima privzeto vrednost *, inherits privzeto vključi dedovanje, izpuščeni initial-value pa pusti zagotovljeno neveljavno začetno vrednost. Specifikacija dovoljuje tudi skrajšani stavek @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, ki vedno ohrani privzeto dedovanje.

Registrirana vrsta se preveri pri izračunani vrednosti, ne ob prvem razčlenjevanju deklaracije. Podana začetna vrednost mora ustrezati slovnici; neznani deskriptorji se prezrejo. Če isto ime registrira več pravil, zmaga zadnje veljavno po vrstnem redu slogovne pole, registracija prek CSS.registerProperty() pa ima prednost pred vsemi pravili.

Registracija omogoča smiselno interpolacijo števil, barv ali dolžin in določi dedovanje API-ja komponente. Primer registrira --tone kot <color> brez dedovanja. Neustrezen 10px prestane razčlenitev deklaracije, vendar odpove pri izračunu, zato otrok dobi zeleno začetno vrednost; veljavna modra ostane modra. Objekt CSSPropertyRule potrdi ime in zastavico dedovanja.

Primeri

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 lastno lastnost z vrsto vrednosti, dedovanjem in začetno vrednostjo.

Viri