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

CKTIS / CSS

Персонализирани CSS свойства: --*

Персонализираните свойства съхраняват стойности под имена, започващи с --. Те участват в каскадата, наследяват се по подразбиране и позволяват на var() да вмъква стойностите им в декларации на други свойства.

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

Синтаксис

--name: <declaration-value>?;
property: var(--name, fallback);

--* обозначава семейството на персонализираните свойства, а не буквално име на декларация. Използвайте валиден идентификатор, започващ с --, например --size; самостоятелното -- е запазено. Различават се главни и малки букви: --size и --Size са различни свойства.

Нерегистрираните персонализирани свойства участват в каскадата и се наследяват. Те съхраняват CSS токени, които не е задължително да са валидна стойност за свойството, което ги използва. var(--size, 20px) замества израза със стойността на --size; резервната стойност се прилага, когато свойството има гарантирано невалидна стойност, включително когато няма декларация, която да я задава. Тя не поправя съществуваща стойност, неподходяща за свойството, което я използва: --size: red няма да задейства резервната стойност за width.

Началната стойност на нерегистрирано свойство е гарантирано невалидна; initial я възстановява. За разлика от нея празната декларация --size:; е валидна празна стойност. Цикличните препратки създават невалидни стойности. В примера първият правоъгълник наследява 40px, а вторият използва резервната стойност 20px след прилагане на initial.

Примери

<!doctype html>
<meta charset="utf-8">
<title>Custom property inheritance</title>
<style>
  .group { --size: 40px; }
  .box {
    width: var(--size, 20px);
    height: 20px;
    background: black;
    margin-bottom: 4px;
  }
  .reset { --size: initial; }
</style>
<div class="group">
  <div class="box"></div>
  <div class="box reset"></div>
</div>

Резултат

.box: width = 40px
.box.reset: width = 20px

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници