The attr()
CSS function is used to retrieve the value of an attribute of the selected element and use it in the style sheet. It can also be used on pseudo-elements, in which case the value of the attribute on the pseudo-element's originating element is returned.
/* Simple usage */ attr(data-count); attr(title); /* With type */ attr(src url); attr(data-count number); attr(data-width px); /* With fallback */ attr(data-count number, 0); attr(src url, '"); attr(data-width px, inherit); attr(data-something, 'default");
Note: The attr()
function can be used with any CSS property, but support for properties other than content
is experimental, and support for the type-or-unit parameter is sparse.
Check the Browser compatibility table carefully before using this in production.
attribute-name
<type-or-unit>
<type-or-unit>
as a value for the given attribute is invalid, the attr()
expression will be invalid too. If omitted, it defaults to string
. The list of valid values are:Keyword | Associated type | Comment | Default value |
---|---|---|---|
string | <string> | The attribute value is treated as a CSS <string> . It is NOT reparsed, and in particular the characters are used as-is instead of CSS escapes being turned into different characters. | An empty string. |
color
| <color> | The attribute value is parsed as a hash (3- or 6-value hash) or a keyword. It must be a valid CSS <string> value.Leading and trailing spaces are stripped. | currentColor |
url
| <url> | The attribute value is parsed as a string that is used inside a CSS url() function.Relative URL are resolved relatively to the original document, not relatively to the style sheet. Leading and trailing spaces are stripped. | The url about:invalid that points to a non-existent document with a generic error condition. |
integer
| <integer> | The attribute value is parsed as a CSS <integer> . If it is not valid, that is not an integer or out of the range accepted by the CSS property, the default value is used.Leading and trailing spaces are stripped. |
0 , or, if 0 is not a valid value for the property, the property's minimum value. |
number
| <number> | The attribute value is parsed as a CSS <number> . If it is not valid, that is not a number or out of the range accepted by the CSS property, the default value is used.Leading and trailing spaces are stripped. |
0 , or, if 0 is not a valid value for the property, the property's minimum value. |
length
| <length> | The attribute value is parsed as a CSS <length> dimension, that is including the unit (e.g. 12.5em ). If it is not valid, that is not a length or out of the range accepted by the CSS property, the default value is used.If the given unit is a relative length, attr() computes it to an absolute length.Leading and trailing spaces are stripped. |
0 , or, if 0 is not a valid value for the property, the property's minimum value. |
em , ex , px , rem , vw , vh , vmin , vmax , mm , cm , in , pt , or pc
| <length> | The attribute value is parsed as a CSS <number> , that is without the unit (e.g. 12.5 ), and interpreted as a <length> with the specified unit. If it is not valid, that is not a number or out of the range accepted by the CSS property, the default value is used.If the given unit is a relative length, attr() computes it to an absolute length.Leading and trailing spaces are stripped. |
0 , or, if 0 is not a valid value for the property, the property's minimum value. |
angle
| <angle> | The attribute value is parsed as a CSS <angle> dimension, that is including the unit (e.g. 30.5deg ). If it is not valid, that is not an angle or out of the range accepted by the CSS property, the default value is used.Leading and trailing spaces are stripped. |
0deg , or, if 0deg is not a valid value for the property, the property's minimum value. |
deg , grad , rad
| <angle> | The attribute value is parsed as a CSS <number> , that is without the unit (e.g. 12.5 ), and interpreted as an <angle> with the specified unit. If it is not valid, that is not a number or out of the range accepted by the CSS property, the default value is used.Leading and trailing spaces are stripped. |
0deg , or, if 0deg is not a valid value for the property, the property's minimum value. |
time
| <time> | The attribute value is parsed as a CSS <time> dimension, that is including the unit (e.g. 30.5ms ). If it is not valid, that is not a time or out of the range accepted by the CSS property, the default value is used.Leading and trailing spaces are stripped. |
0s , or, if 0s is not a valid value for the property, the property's minimum value. |
s , ms
| <time> | The attribute value is parsed as a CSS <number> , that is without the unit (e.g. 12.5 ), and interpreted as an<time> with the specified unit. If it is not valid, that is not a number or out of the range accepted by the CSS property, the default value is used.Leading and trailing spaces are stripped. |
0s , or, if 0s is not a valid value for the property, the property's minimum value. |
frequency
| <frequency> | The attribute value is parsed as a CSS <frequency> dimension, that is including the unit (e.g. 30.5kHz ). If it is not valid, that is not a frequency or out of the range accepted by the CSS property, the default value is used. |
0Hz , or, if 0Hz is not a valid value for the property, the property's minimum value. |
Hz , kHz
| <frequency> | The attribute value is parsed as a CSS <number> , that is without the unit (e.g. 12.5 ), and interpreted as a <frequency> with the specified unit. If it is not valid, that is not a number or out of the range accepted by the CSS property, the default value is used.Leading and trailing spaces are stripped. |
0Hz , or, if 0Hz is not a valid value for the property, the property's minimum value. |
%
| <percentage> | The attribute value is parsed as a CSS <number> , that is without the unit (e.g. 12.5 ), and interpreted as a <percentage> . If it is not valid, that is not a number or out of the range accepted by the CSS property, the default value is used.If the given value is used as a length, attr() computes it to an absolute length.Leading and trailing spaces are stripped. |
0% , or, if 0% is not a valid value for the property, the property's minimum value. |
<fallback>
attr()
is used, even if it is not used, and must not contain another attr()
expression. If attr()
is not the sole component value of a property, its <fallback>
value must be of the type defined by <type-or-unit>
. If not set, CSS will use the default value defined for each <type-or-unit>
.attr( <attr-name> <type-or-unit>? [, <attr-fallback> ]? )where
<type-or-unit> = string | integer | color | url | integer | number | length | angle | time | frequency | em | ex | px | rem | vw | vh | vmin | vmax | mm | q | cm | in | pt | pc | deg | grad | rad | ms | s | Hz | kHz | %
content
property<p data-foo="hello">world</p>
[data-foo]::before { content: attr(data-foo) " "; }
<color>
value This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
<div class="background" data-background="lime"></div>
.background { background-color: red; } .background[data-background] { background-color: attr(data-background color, red); }
Specification | Status | Comment |
---|---|---|
CSS Values and Units Module Level 4 The definition of 'attr()' in that specification. | Editor's Draft | No changes. |
CSS Values and Units Module Level 3 The definition of 'attr()' in that specification. | Candidate Recommendation | Added two optional parameters; can be used on all properties; may return other values than <string> . These changes are experimental and may be dropped during the CR phase if browser support is too small. |
CSS Level 2 (Revision 1) The definition of 'attr()' in that specification. | Recommendation | Limited to the content property; always return a <string> . |
Desktop | ||||||
---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | |
Basic support | 2 | 12 | 1 | 8 | 9 | 3.1 |
<fallback> | No | No | No | No | No | No |
<type-or-unit> | No | No | No | No | No | No |
Mobile | |||||||
---|---|---|---|---|---|---|---|
Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
Basic support | Yes | 18 | 12 | 4 | 10 | 3.1 | Yes |
<fallback> | No | No | No | No | No | No | No |
<type-or-unit> | No | No | No | No | No | No | No |
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/attr