--- title: attr slug: Web/CSS/attr tags: - CSS - CSS Funktion - Layout - Referenz - Web translation_of: Web/CSS/attr() original_slug: Web/CSS/attr() ---
{{ CSSRef() }}
Die attr()
CSS Funktion wird verwendet, um einen Wert eines Attributs des ausgewählten Elements abzurufen und innerhalb des Stylesheets zu verwenden. Sie kann auch für Pseudoelemente verwendet werden. In diesem Fall wird der Wert des Attributs seines ursprünglichen Elements zurückgegeben.
Die attr()
Funktion kann innerhalb jeder CSS Eigenschaft verwendet werden. {{ experimental_inline() }}
Formale Syntax: attr( attribute-name <type-or-unit>? [, <fallback> ]? )
attribute-name
<type-
or-unit><type-or-unit>
als Wert für das angegebene Attribut ungültig ist, ist der attr()
Ausdruck ebenfalls ungültig. Falls nicht angegeben, wird standardmäßig string
verwendet. Nachfolgend ist eine Liste aller Werte aufgeführt:
Schlüsselwort | Assoziierter Typ | Anmerkung | Standardwert |
---|---|---|---|
string |
{{cssxref("<string>")}} | Der Attributwert wird als CSS {{cssxref("<string>")}} Wert behandelt. Er wird nicht erneut geparst, insbesondere werden die Zeichen wie angegeben verwendet, anstatt dass CSS Escapes zu anderen Zeichen umgewandelt werden. | An empty string |
color {{ experimental_inline() }} |
{{cssxref("<color>")}} | Der Attributwert wird als Hash (3- oder 6-Werthash) oder als Schlüsselwort interpretiert. Er muss ein gültiger CSS {{cssxref("<string>")}} Wert sein. Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
currentColor |
url {{ experimental_inline() }} |
{{ cssxref("<uri>") }} | Der Attributwert wird als ein String interpretiert, wie er in einer url() Funktion verwendet wird. Relative URLs werden relativ zum ursprünglichen Dokument interpretiert, nicht relativ zum Stylesheet.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
Die URL about:invalid , die auf ein nicht existierendes Dokument mit einer allgemeinen Fehlermeldung verweist. |
integer {{ experimental_inline() }} |
{{cssxref("<integer>")}} | Der Attributwert wird als CSS {{cssxref("<integer>")}} Wert interpretiert. Falls er nicht gültig ist, d. h. keine Ganzzahl oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet. Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0 oder, falls 0 kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
number {{ experimental_inline() }} |
{{cssxref("<number>")}} | Der Attributwert wird als CSS {{cssxref("<number>")}} Wertinterpretiert. Falls er nicht gültig ist, d. h. keine Zahl oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet. Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0 oder, falls 0 kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
length {{ experimental_inline() }} |
{{cssxref("<length>")}} | Der Attributwert wird als CSS {{cssxref("<length>")}} Wert interpretiert, der die Einheit beinhaltet (z. B. 12.5em ). Falls er ungültig ist, d. h. keine Länge oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Falls die angegebene Einheit eine relative Länge ist, wandelt attr() sie in eine absolute Länge um.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0 oder, falls 0 kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
em , ex , px , rem , vw , vh , vmin , vmax , mm , cm , in , pt , oder pc {{ experimental_inline() }} |
{{cssxref("<length>")}} | Der Attributwert wird als CSS {{cssxref("<number>")}} Wert ohne Einheit interpretiert (z. B. 12.5 ) und in einen {{cssxref("<length>")}} Wert mit der angegebenen Einheit umgewandelt. Falls er nicht gültig ist, d. h. keine Zahl oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Falls die angegebene Einheit eine relative Länge ist, wandelt attr() sie in eine absolute Länge um.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0 oder, falls 0 kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
angle {{ experimental_inline() }} |
{{ cssxref("<angle>") }} | Der Attributwert wird als CSS {{ cssxref("<angle>") }} Wert interpretiert, der die Einheit beinhaltet (z. B. 30.5deg ). Falls er ungültig ist, d. h. kein Winkel oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0deg oder, falls 0deg kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
deg , grad , rad {{ experimental_inline() }} |
{{ cssxref("<angle>") }} | Der Attributwert wird als CSS {{cssxref("<number>")}} Wert ohne Einheit interpretiert (z. B. 12.5 ) und in einen {{ cssxref("<angle>") }} Wert mit der angegebenen Einheit umgewandelt. Falls er nicht gültig ist, d. h. keine Zahl oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0deg oder, falls 0deg kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
time {{ experimental_inline() }} |
{{cssxref("<time>")}} | Der Attributwert wird als CSS {{cssxref("<time>")}} Wert interpretiert, der die Einheit beinhaltet (z. B. 30.5ms ). Falls er ungültig ist, d. h. keine Zeit oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0s oder, falls 0s kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
s , ms {{ experimental_inline() }} |
{{cssxref("<time>")}} | Der Attributwert wird als CSS {{cssxref("<number>")}} Wert ohne Einheit interpretiert (z. B. 12.5 ) und in einen {{cssxref("<time>")}} Wert mit der angegebenen Einheit umgewandelt. Falls er nicht gültig ist, d. h. keine Zeit oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0s oder, falls 0s kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
frequency {{ experimental_inline() }} |
{{cssxref("<frequency>")}} | Der Attributwert wird als CSS {{cssxref("<frequency>")}} Wert interpretiert, der die Einheit beinhaltet (z. B. 30.5kHz ). Falls er ungültig ist, d. h. keine Frequenz oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0Hz oder, falls 0Hz kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
Hz , kHz {{ experimental_inline() }} |
{{cssxref("<frequency>")}} | Der Attributwert wird als CSS {{cssxref("<number>")}} Wert ohne Einheit interpretiert (z. B. 12.5 ) und in einen {{cssxref("<frequency>")}} Wert mit der angegebenen Einheit umgewandelt. Falls er nicht gültig ist, d. h. keine Frequenz oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0Hz oder, falls 0Hz kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
% {{ experimental_inline() }} |
{{cssxref("<percentage>")}} | Der Attributwert wird als CSS {{cssxref("<number>")}} Wert ohne Einheit interpretiert (z. B. 12.5 ) und in einen {{cssxref("<percentage>")}} Wert umgewandelt. Falls er nicht gültig ist, d. h. keine Zahl oder außerhalb des Bereichs, der von der CSS Eigenschaft akzeptiert wird, wird der Standardwert verwendet.Falls der Wert als Länge verwendet wird, wandelt attr() ihn in eine absolute Länge um.Voran- und nachgestellte Leerzeichen werden abgeschnitten. |
0% oder, falls 0% kein gültiger Wert für die Eigenschaft ist, der Minimalwert der Eigenschaft. |
<fallback>
attr()
Ausdruck beinhalten. Falls attr()
nicht der einzige Wert einer Eigenschaft ist, muss dessen <fallback>
Wert von dem Typ sein, der durch <type-or-unit>
definiert wird. Falls nicht angegeben, wird CSS den Standardwert verwenden, der für jeden <type-or-unit>
Wert angegeben ist.p:before { content:attr(data-foo) " "; }
<p data-foo="Hallo">Welt</p>
{{ EmbedLiveSample("Beispiele", '100%', '60') }}
Spezifikation | Status | Anmerkung |
---|---|---|
{{ SpecName('CSS3 Values', '#attr', 'attr()') }} | {{ Spec2('CSS3 Values') }} | Fügt zwei optionale Parameter hinzu; kann in allen Eigenschaften verwendet werden; kann andere Werte als {{cssxref("<string>")}} zurückliefern. Diese Änderungen sind als experimentell {{ experimental_inline() }} markiert und können jederzeit während der CR Phase verworfen werden, falls die Browserunterstützung nicht groß genug ist. |
{{ SpecName('CSS2.1', 'generate.html#x18', 'attr()') }} | {{ Spec2('CSS2.1') }} | Beschränkt auf die {{ cssxref("content") }} Eigenschaft; gibt immer {{cssxref("<string>")}} zurück. |