CKTIS / CSS
@property — Registrierung typisierter eigener Eigenschaften
Die Regel @property registriert eine eigene Eigenschaft mit Werttyp, Vererbungsverhalten und Anfangswert.
Version: 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>? ]? ;Die Blockform @property <custom-property-name># { <declaration-list> } kann einen Namen oder eine kommagetrennte Namensliste registrieren. Der Deskriptor syntax hat den Standardwert *, inherits aktiviert standardmäßig die Vererbung, und ohne initial-value bleibt der garantiert ungültige Anfangswert. Die Spezifikation erlaubt außerdem die Anweisungs-Kurzform @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, die stets das voreingestellte Vererbungsverhalten behält.
Der registrierte Typ wird zur Zeit des berechneten Werts geprüft, nicht beim ersten Parsen der Deklaration. Ein angegebener Anfangswert muss zur Grammatik passen; unbekannte Deskriptoren werden ignoriert. Registrieren mehrere Regeln denselben Namen, gewinnt die letzte gültige in Stylesheet-Reihenfolge; eine Registrierung über CSS.registerProperty() hat jedoch Vorrang vor allen Regeln.
Die Registrierung ermöglicht sinnvolle Interpolation von Zahlen, Farben oder Längen und legt Vererbung für eine Komponenten-API fest. Das Beispiel registriert --tone als <color> ohne Vererbung. Das unpassende 10px wird zunächst geparst, scheitert aber beim berechneten Wert; das Kind erhält deshalb den grünen Anfangswert, während gültiges Blau erhalten bleibt. CSSPropertyRule bestätigt Namen und Vererbungsflag.
Beispiele
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);Ergebnis
rule=CSSPropertyRule; name=--tone; invalid=rgb(0, 128, 0); valid=rgb(0, 0, 255); inherits=false
Die Regel @property registriert eine eigene Eigenschaft mit Werttyp, Vererbungsverhalten und Anfangswert.