База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

@property — типизирана регистрация на персонализирано свойство

Правилото @property регистрира персонализирано свойство с тип стойност, наследяване и начална стойност.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

@property <custom-property-name># {
  <declaration-list>
} | @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;

Блоковата форма @property <custom-property-name># { <declaration-list> } може да регистрира едно име или списък, разделен със запетаи. Дескрипторът syntax има стойност по подразбиране *, inherits по подразбиране включва наследяването, а пропуснатият initial-value оставя гарантирано невалидната начална стойност. Спецификацията допуска и съкратена инструкция @property <custom-property-name> <css-type>? [ : <declaration-value>? ]? ;, която винаги запазва наследяването по подразбиране.

Регистрираният тип се проверява при изчислената стойност, а не при първоначалния анализ на декларацията. Зададена начална стойност трябва да съответства на граматиката; непознатите дескриптори се игнорират. Ако няколко правила регистрират едно име, печели последното валидно по реда в таблицата, докато регистрация чрез CSS.registerProperty() има предимство пред всички тях.

Регистрацията позволява смислена интерполация на числа, цветове или дължини и определя наследяването на API за компонент. Примерът регистрира --tone като <color> без наследяване. Несъответстващото 10px минава анализа на декларацията, но се проваля при изчисляването, затова наследникът получава зелената начална стойност; валидното синьо остава синьо. Обектът CSSPropertyRule потвърждава името и флага за наследяване.

Примери

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

Резултат

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

Правилото @property регистрира персонализирано свойство с тип стойност, наследяване и начална стойност.

Източници