WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

CSS benutzerdefinierte Eigenschaften: --*

Benutzerdefinierte Eigenschaften speichern Werte unter Namen, die mit -- beginnen. Sie nehmen an der Kaskade teil, werden standardmäßig vererbt und ermöglichen es, ihre Werte mit var() in Deklarationen anderer Eigenschaften einzusetzen.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

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

--* bezeichnet die Familie benutzerdefinierter Eigenschaften, nicht einen wörtlichen Deklarationsnamen. Verwende einen gültigen Bezeichner, der mit -- beginnt, zum Beispiel --size; -- allein ist reserviert. Bei Namen wird zwischen Groß- und Kleinschreibung unterschieden: --size und --Size sind unterschiedliche Eigenschaften.

Nicht registrierte benutzerdefinierte Eigenschaften nehmen an der Kaskade teil und werden vererbt. Sie speichern CSS-Token, die nicht unbedingt einen gültigen Wert für die verwendende Eigenschaft darstellen. var(--size, 20px) setzt den Wert von --size ein; der Ersatzwert gilt, wenn diese Eigenschaft den garantiert ungültigen Wert hat, auch wenn keine Deklaration dafür vorliegt. Er korrigiert keinen vorhandenen Wert, der für die verwendende Eigenschaft ungeeignet ist: --size: red löst bei width nicht den Ersatzwert aus.

Der Anfangswert einer nicht registrierten Eigenschaft ist garantiert ungültig; initial stellt ihn wieder her. Die leere Deklaration --size:; ist dagegen ein gültiger leerer Wert. Zyklische Verweise ergeben ungültige Werte. Im Beispiel erbt das erste Rechteck 40px, während das zweite nach Anwendung von initial den Ersatzwert 20px verwendet.

Beispiele

<!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>

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen