Werte aus HTML-Attributen direkt in CSS verwenden

HTML-Attribute können Werte wie Farben, Grössen oder Fortschrittsstände direkt am Element speichern. Die erweiterte CSS-Funktion attr() übernimmt solche Werte in CSS-Eigenschaften.

3 Min. von Erhard Sigrist

Ein HTML-Element kann neben seinem Inhalt zusätzliche Angaben mitbringen. Ein data-*-Attribut speichert beispielsweise eine Farbe, eine Grösse oder einen Prozentwert. Mit der erweiterten Syntax von attr() liest CSS diese Werte aus und verwendet sie für die Gestaltung einzelner Interface-Elemente.

Lange war attr() vor allem für generierte Inhalte mit content vorgesehen. Die erweiterte Syntax verarbeitet Attributwerte mit einem definierten Datentyp und macht sie für Eigenschaften wie Farben, Abmessungen oder Schriftgrössen verfügbar.

Farbe direkt am HTML-Element hinterlegen

Das folgende Beispiel speichert die Hintergrundfarbe im Attribut data-color:

<div class="my-box" data-color="#00ccff">
	Box mit eigener Hintergrundfarbe
</div>

<div class="my-box">
	Box mit Fallback
</div>

Das zugehörige CSS:

.my-box {
	background-color: red;
	background-color: attr(data-color type(<color>), red);
}

Die erste Deklaration liefert die Grunddarstellung. Die zweite Deklaration verwendet data-color, sobald der Browser die erweiterte attr()-Syntax verarbeitet.

Die erste Box erhält die Farbe #00ccff aus dem Attribut. Die zweite Box verwendet red, weil sie keinen eigenen Farbwert enthält.

Die drei Teile der Syntax verstehen

background-color: attr(data-color type(<color>), red);

Die Funktion verbindet drei Angaben:

  • data-color bezeichnet das HTML-Attribut.
  • type(<color>) legt fest, dass CSS den Wert als Farbe verarbeitet.
  • red definiert die Farbe für Elemente ohne gültigen Attributwert.

Die Typangabe ordnet dem Attribut einen klaren CSS-Wert zu. So verwendet die Eigenschaft nur Werte, die zum vorgesehenen Datentyp passen.

Weitere Datentypen einsetzen

Neben Farben verarbeitet die Funktion unter anderem Zahlen, Längen, Prozentwerte, Winkel und Ganzzahlen. Ein Prozentwert eignet sich beispielsweise für eine Fortschrittsanzeige:

<div class="progress" data-progress="65%"></div>
.progress {
	width: 0%;
	width: attr(data-progress type(<percentage>), 0%);
}

Die Spezifikation hält die dynamische Erzeugung von URLs aus Attributwerten aus Sicherheitsgründen ausserhalb der Funktion. Weitere Hintergründe beschreibt CSS Values and Units Level 5.

Browser-Unterstützung mit einer Grunddarstellung verbinden

Die klassische Verwendung von attr() innerhalb von content wird breit unterstützt. Typisierte Attributwerte in weiteren CSS-Eigenschaften stehen als neuere Funktion zur Verfügung. Chromium unterstützt sie seit Chrome 133; weitere Hinweise bieten Chrome for Developers und MDN.

Eine normale CSS-Deklaration bildet deshalb die Grunddarstellung:

.my-box {
	background-color: red;
	background-color: attr(data-color type(<color>), red);
}

Bei umfangreicheren Anwendungen kann @supports die erweiterte Syntax abfragen:

@supports (background-color: attr(data-color type(<color>), red)) {
	.my-box {
		background-color: attr(data-color type(<color>), red);
	}
}

Ergebnis

HTML-Attribute für einzelne CSS-Werte nutzen

Die erweiterte attr()-Funktion verbindet Werte im HTML-Markup direkt mit CSS-Eigenschaften. Sie eignet sich für elementbezogene Einstellungen, die als data-*-Attribute bereits am Element vorhanden sind.

Attribute mit CSS verbinden

attr() liest Werte aus HTML-Attributen und übergibt sie an die CSS-Eigenschaft des jeweiligen Elements.

Passende Typen verwenden

type(<color>), Prozentwerte und weitere Datentypen geben den Attributwerten eine eindeutige Bedeutung in CSS.

Grunddarstellung erhalten

Eine normale CSS-Deklaration liefert die Darstellung. attr() ergänzt sie in Browsern mit Unterstützung für die erweiterte Syntax.