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.