1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
---
title: attr()
slug: Web/CSS/attr()
tags:
- CSS
- CSS 関数
- 関数
- レイアウト
- リファレンス
- ウェブ
- attr
browser-compat: css.types.attr
translation_of: Web/CSS/attr()
---
{{CSSRef}}
> **Note:** `attr()` 関数はどの CSS プロパティでも使用することができますが、 {{CSSxRef("content")}} 以外のプロパティでの対応は実験的であり、型や単位の引数の対応はまちまちです。
**`attr()`** は [CSS](/ja/docs/Web/CSS) の[関数](/ja/docs/Web/CSS/CSS_Functions)で、選択された要素の属性の値を受け取り、スタイルシートの中で使うために使用されます。[擬似要素](/ja/docs/Web/CSS/Pseudo-elements)で使用することもでき、その場合は擬似要素を作る元になった要素の属性値が返されます。
```css
/* 単純な使用法 */
attr(data-count);
attr(title);
/* 型付き */
attr(src url);
attr(data-count number);
attr(data-width px);
/* 代替値付き */
attr(data-count number, 0);
attr(src url, "");
attr(data-width px, inherit);
attr(data-something, "default");
```
## 構文
### 値
- `attribute-name`
- : CSS で参照する、 HTML 要素の属性名です。
- `<type-or-unit>` {{Experimental_Inline}}
- : 属性値の型またはその単位を示すキーワードです。 HTML では暗黙に単位を持つ属性があります。属性に対して無効な値を `<type-or-unit>` で与えると、 `attr()` 式も無効になります。省略すると既定値の `string` になります。有効な値は以下の通りです。
- `string`
- : 属性値は CSS {{CSSxRef("<string>")}} として扱われます。再解析はされず、特に文字は CSS エスケープで他の文字に変換されることなく、そのまま使用されます。
既定値は空文字列です。
- `color` {{Experimental_Inline}}
- : 属性値はハッシュ (3 値または 6 値のハッシュ) またはキーワードとして解析されます。妥当な CSS の {{CSSxRef("<string>")}} 値でなければなりません。前後の空白は除去されます。
既定値は `currentcolor` です。
- `url` {{Experimental_Inline}}
- : 属性値は、 CSS の `url()` 関数の中で使用される文字列として解析されます。
相対 URL は、スタイルシートからの相対ではなく、元の文書からの相対で解決されます。
前後の空白は除去されます。
既定値は、一般的なエラーの状況で存在しない文書を指す `about:invalid` の URL です。
- `integer` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<integer>")}} として解析されます。妥当ではない場合、つまり整数ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
前後の空白は除去されます。
既定値は `0`、または `0` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `number` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<number>")}} として解析されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
前後の空白は除去されます。
既定値は `0`、または `0` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `length` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<length>")}} の距離として単位を含んで (`12.5em` など) 解釈されます。妥当ではない場合、つまり長さではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
指定された値が相対的な長さの場合は、 `attr()` は絶対的な値に変換して計算します。<br>
前後の空白は除去されます。
既定値は `0`、または `0` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `em`, `ex`, `px`, `rem`, `vw`, `vh`, `vmin`, `vmax`, `mm`, `cm`, `in`, `pt`, or `pc` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (`12.5` など) で解析され、特定の単位を付けた {{CSSxRef("<length>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
指定された値が相対的な長さの場合は、 `attr()` は絶対的な値に変換して計算します。<br>
前後の空白は除去されます。
既定値は `0`、または `0` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `angle` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<angle>")}} の大きさとして単位を含んで (`30.5deg` など) 解釈されます。妥当ではない場合、つまり角度ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
前後の空白は除去されます。
既定値は `0deg`、または `0deg` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `deg`, `grad`, `rad` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (`12.5` など) で解析され、特定の単位を付けた {{CSSxRef("<angle>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
前後の空白は除去されます。
既定値は `0deg`、または `0deg` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `time` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<time>")}} の大きさとして単位を含んで (`30.5ms` など) 解釈されます。妥当ではない場合、つまり時間ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
前後の空白は除去されます。
既定値は `0s`、または `0s` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `s`, `ms` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (`12.5` など) で解析され、特定の単位を付けた {{CSSxRef("<time>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
前後の空白は除去されます。
既定値は `0s`、または `0s` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `frequency` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<frequency>")}} の大きさとして単位を含んで (`30.5ms` など) 解釈されます。妥当ではない場合、つまり周波数ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
既定値は `0Hz`、または `0Hz` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `Hz`, `kHz` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (`12.5` など) で解析され、特定の単位を付けた {{CSSxRef("<frequency>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
前後の空白は除去されます。
既定値は `0Hz`、または `0Hz` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `%` {{Experimental_Inline}}
- : 属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (`12.5` など) で解析され、 {{CSSxRef("<percentage>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。
指定された値が長さの場合は、 `attr()` は絶対的な値に変換して計算します。
前後の空白は除去されます。
既定値は `0%`、または `0%` が妥当な値ではないプロパティでは、プロパティの最小値です。
- `<fallback>` {{Experimental_Inline}}
- : 関連する属性が見つからないか、無効値を含むときに使われる値です。設定されていない場合は、 CSS は各 `<type-or-unit>` で定義された既定値を使います。
### 形式文法
{{CSSSyntax}}
## 例
<h3 id="content_property">content プロパティ</h3>
#### HTML
```html
<p data-foo="hello">world</p>
```
#### CSS
```css
[data-foo]::before {
content: attr(data-foo) " ";
}
```
#### 結果
{{EmbedLiveSample("content_property", "100%", 50)}}
<h3 id="color_value"><color> 値</h3>
{{SeeCompatTable}}
#### 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 hidden
.background {
height: 100vh;
}
```
```css
.background {
background-color: red;
}
.background[data-background] {
background-color: attr(data-background color, red);
}
```
#### 結果
{{EmbedLiveSample("color_value", "100%", 50)}}
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}
## 関連情報
- [属性セレクター](/ja/docs/Web/CSS/Attribute_selectors)
- [HTML `data-*` 属性](/ja/docs/Web/HTML/Global_attributes/data-*)
- [SVG `data-*` 属性](/ja/docs/Web/SVG/Attribute/data-*)
|
