attr()

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.

The attr() CSS function is used to retrieve the value of an attribute of the selected element and use it in the stylesheet. 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.

Try it

Syntax

css
/* 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");

Values

attribute-name

The name of an attribute on the HTML element referenced in the CSS.

<type-or-unit>

A keyword representing either the type of the attribute's value, or its unit, as in HTML some attributes have implicit units. If the use of <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:

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.

Default value: an empty string.

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.

Default value: currentcolor.

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.

Default value: the URL about:invalid that points to a non-existent document with a generic error condition.

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.

Default value: 0, or, if 0 is not a valid value for the property, the property's minimum value.

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.

Default value: 0, or, if 0 is not a valid value for the property, the property's minimum value.

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.

Default value: 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

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.

Default value: 0, or, if 0 is not a valid value for the property, the property's minimum value.

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.

Default value: 0deg, or, if 0deg is not a valid value for the property, the property's minimum value.

deg, grad, rad

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.

Default value: 0deg, or, if 0deg is not a valid value for the property, the property's minimum value.

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.

Default value: 0s, or, if 0s is not a valid value for the property, the property's minimum value.

s, ms

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.

Default value: 0s, or, if 0s is not a valid value for the property, the property's minimum value.

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.

Default value: 0Hz, or, if 0Hz is not a valid value for the property, the property's minimum value.

Hz, kHz

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.

Default value: 0Hz, or, if 0Hz is not a valid value for the property, the property's minimum value.

%

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.

Default value: 0%, or, if 0% is not a valid value for the property, the property's minimum value.

<fallback>

The value to be used if the associated attribute is missing or contains an invalid value. If not set, CSS will use the default value defined for each <type-or-unit>.

Formal syntax

<attr()> = 
attr( <attr-name> <attr-type>? , <declaration-value>? )

<attr-name> =
[ <ident-token> '|' ]? <ident-token>

<attr-type> =
string |
ident |
color |
number |
percentage |
length |
angle |
time |
frequency |
flex |
<dimension-unit>

Examples

content property

In this example, we prepend the value of the data-foo data-* global attribute to the contents of the <p> element.

HTML

html
<p data-foo="hello">world</p>

CSS

css
[data-foo]::before {
  content: attr(data-foo) " ";
}

Result

color value

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

In this example, we set the CSS value of background-color to the value of the data-background data-* global attribute assigned to the <div> element.

HTML

html
<div class="background" data-background="lime">
  background expected to be red if your browser does not support advanced usage
  of attr()
</div>

CSS

css
.background {
  background-color: red;
}

.background[data-background] {
  background-color: attr(data-background color, red);
}

Result

using fallback

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

In this example, we append the value of data-browser data-* global attribute to the <p> element. If the data-browser attribute is missing from the <p> element, we append the fallback value of "Unknown".

HTML

html
<p data-browser="Firefox">My favorite browser is:</p>
<p>Your favorite browser is:</p>

CSS

css
p::after {
  content: " " attr(data-browser, "Unknown");
  color: tomato;
}

Result

Specifications

Specification
CSS Values and Units Module Level 5
# attr-notation

Browser compatibility

BCD tables only load in the browser

See also