KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

@property — getypeerde registratie van een aangepaste eigenschap

De regel @property registreert een aangepaste eigenschap met waardetype, overerving en een beginwaarde.

Versie: 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>? ]? ;

De blokvorm @property <custom-property-name># { <declaration-list> } kan één naam of een kommagescheiden namenlijst registreren. Descriptor syntax heeft standaardwaarde *, inherits schakelt standaard overerving in en zonder initial-value blijft de gegarandeerd ongeldige beginwaarde gelden. De specificatie staat ook de verkorte instructie @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ; toe; die behoudt altijd het standaardgedrag voor overerving.

Het geregistreerde type wordt bij de berekende waarde gecontroleerd, niet tijdens het eerste parsen van de declaratie. Een opgegeven beginwaarde moet aan de grammatica voldoen; onbekende descriptors worden genegeerd. Registreren meerdere regels dezelfde naam, dan wint de laatste geldige regel in stylesheetvolgorde, terwijl registratie via CSS.registerProperty() voorrang op alle regels heeft.

Registratie maakt zinvolle interpolatie van getallen, kleuren of lengtes en expliciete overerving voor een component-API mogelijk. Het voorbeeld registreert --tone als <color> zonder overerving. Het onpassende 10px wordt als declaratie geparseerd maar faalt bij de berekende waarde; het kind krijgt dus de groene beginwaarde, terwijl geldig blauw blauw blijft. CSSPropertyRule bevestigt naam en overervingsvlag.

Voorbeelden

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);

Resultaat

rule=CSSPropertyRule; name=--tone; invalid=rgb(0, 128, 0); valid=rgb(0, 0, 255); inherits=false

De regel @property registreert een aangepaste eigenschap met waardetype, overerving en een beginwaarde.

Bronnen