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.
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-colorbezeichnet das HTML-Attribut.type(<color>)legt fest, dass CSS den Wert als Farbe verarbeitet.reddefiniert 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.