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
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
|
---
title: attr()
slug: Web/CSS/attr()
tags:
- CSS
- CSS 関数
- Reference
- Web
- attr
- レイアウト
translation_of: Web/CSS/attr()
---
<div>{{CSSRef}}</div>
<div class="blockIndicator note"><strong>メモ:</strong> <code>attr()</code> 関数はどの CSS プロパティでも使用することができますが、 {{CSSxRef("content")}} 以外のプロパティでの対応は実験的であり、型や単位の引数の対応はまちまちです。</div>
<p><strong><code>attr()</code></strong> は <a href="/ja/docs/Web/CSS">CSS</a> の関数で、選択された要素の属性の値を受け取り、スタイルシートの中で使うために使用されます。<a href="/ja/docs/Web/CSS/Pseudo-elements">擬似要素</a>で使用することもでき、その場合は擬似要素を作る元になった要素の属性値が返されます。</p>
<pre class="brush: css no-line-numbers notranslate">/* Simple usage */
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");
</pre>
<h2 id="Syntax" name="Syntax">構文</h2>
<h3 id="Values" name="Values">値</h3>
<dl>
<dt><code>attribute-name</code></dt>
<dd>CSS で参照する、 HTML 要素の属性名です。</dd>
<dt><code style="white-space: nowrap;"><type-or-unit></code> {{Experimental_Inline}}</dt>
<dd>属性値の型またはその単位を示すキーワードです。 HTML では暗黙に単位を持つ属性があります。属性に対して無効な値を <code><type-or-unit></code> で与えると、 <code>attr()</code> 式も無効になります。省略すると既定値の <code>string</code> になります。有効な値は以下の通りです。
<table class="standard-table">
<thead>
<tr>
<th scope="col">キーワード</th>
<th scope="col">関係する型</th>
<th scope="col">コメント</th>
<th scope="col">既定値</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>string</code></td>
<td style="white-space: nowrap;">{{CSSxRef("<string>")}}</td>
<td>属性値は CSS {{CSSxRef("<string>")}} として扱われます。再解析はされず、特に文字は CSS エスケープで他の文字に変換されることなく、そのまま使用されます。</td>
<td>空文字列</td>
</tr>
<tr>
<td><code>color</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<color>")}}</td>
<td>属性値はハッシュ (3値または6値のハッシュ) またはキーワードとして解析されます。妥当な CSS の {{CSSxRef("<string>")}} 値でなければなりません。<br>
前後の空白は除去されます。</td>
<td><code>currentcolor</code></td>
</tr>
<tr>
<td><code>url</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<url>")}}</td>
<td>属性値は、 CSS の <code>url()</code> 関数の中で使用される文字列として解析されます。<br>
相対 URL は、スタイルシートからの相対ではなく、元の文書からの相対で解決されます。<br>
前後の空白は除去されます。</td>
<td>一般的なエラーの状況で存在しない文書を指す <code>about:invalid</code> の URL。</td>
</tr>
<tr>
<td><code>integer</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<integer>")}}</td>
<td>属性値は CSS の {{CSSxRef("<integer>")}} として解析されます。妥当ではない場合、つまり整数ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
前後の空白は除去されます。</td>
<td><code>0</code>、または <code>0</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>number</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<number>")}}</td>
<td>属性値は CSS の {{CSSxRef("<number>")}} として解析されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
前後の空白は除去されます。</td>
<td><code>0</code>、または <code>0</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>length</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<length>")}}</td>
<td>属性値は CSS の {{CSSxRef("<length>")}} の距離として単位を含んで (<code>12.5em</code> など) 解釈されます。妥当ではない場合、つまり長さではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
指定された値が相対的な長さの場合は、 <code>attr()</code> は絶対的な値に変換して計算します。<br>
前後の空白は除去されます。</td>
<td><code>0</code>、または <code>0</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>em</code>, <code>ex</code>, <code>px</code>, <code>rem</code>, <code>vw</code>, <code>vh</code>, <code>vmin</code>, <code>vmax</code>, <code>mm</code>, <code>cm</code>, <code>in</code>, <code>pt</code>, or <code>pc</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<length>")}}</td>
<td>属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (<code>12.5</code> など) で解析され、特定の単位を付けた {{CSSxRef("<length>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
指定された値が相対的な長さの場合は、 <code>attr()</code> は絶対的な値に変換して計算します。<br>
前後の空白は除去されます。</td>
<td><code>0</code>、または <code>0</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>angle</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<angle>")}}</td>
<td>属性値は CSS の {{CSSxRef("<angle>")}} の大きさとして単位を含んで (<code>30.5deg</code> など) 解釈されます。妥当ではない場合、つまり角度ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
前後の空白は除去されます。</td>
<td><code>0deg</code>、または <code>0deg</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>deg</code>, <code>grad</code>, <code>rad</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<angle>")}}</td>
<td>属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (<code>12.5</code> など) で解析され、特定の単位を付けた {{CSSxRef("<angle>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
前後の空白は除去されます。</td>
<td><code>0deg</code>、または <code>0deg</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>time</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<time>")}}</td>
<td>属性値は CSS の {{CSSxRef("<time>")}} の大きさとして単位を含んで (<code>30.5ms</code> など) 解釈されます。妥当ではない場合、つまり時間ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
前後の空白は除去されます。</td>
<td><code>0s</code>、または <code>0s</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>s</code>, <code>ms</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<time>")}}</td>
<td>属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (<code>12.5</code> など) で解析され、特定の単位を付けた {{CSSxRef("<time>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
前後の空白は除去されます。</td>
<td><code>0s</code>、または <code>0s</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>frequency</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<frequency>")}}</td>
<td>属性値は CSS の {{CSSxRef("<frequency>")}} の大きさとして単位を含んで (<code>30.5ms</code> など) 解釈されます。妥当ではない場合、つまり周波数ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。</td>
<td><code>0Hz</code>、または <code>0Hz</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>Hz</code>, <code>kHz</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<frequency>")}}</td>
<td>属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (<code>12.5</code> など) で解析され、特定の単位を付けた {{CSSxRef("<frequency>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
前後の空白は除去されます。</td>
<td><code>0Hz</code>、または <code>0Hz</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
<tr>
<td><code>%</code> {{Experimental_Inline}}</td>
<td style="white-space: nowrap;">{{CSSxRef("<percentage>")}}</td>
<td>属性値は CSS の {{CSSxRef("<number>")}}、つまり単位なし (<code>12.5</code> など) で解析され、 {{CSSxRef("<percentage>")}} として解釈されます。妥当ではない場合、つまり数値ではない場合や CSS プロパティが受け入れ可能な範囲を超えていた場合は、既定値が使用されます。<br>
指定された値が長さの場合は、 <code>attr()</code> は絶対的な値に変換して計算します。<br>
前後の空白は除去されます。</td>
<td><code>0%</code>、または <code>0%</code> が妥当な値ではないプロパティでは、プロパティの最小値。</td>
</tr>
</tbody>
</table>
</dd>
<dt><code><fallback></code> {{Experimental_Inline}}</dt>
<dd>関連する属性が見つからないか、無効値を含むときに使われる値です。設定されていない場合は、 CSS は各 <code><type-or-unit></code> で定義された既定値を使います。</dd>
</dl>
<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
{{CSSSyntax}}
<h2 id="Examples" name="Examples">例</h2>
<h3 id="content_property" name="content_property">content プロパティ</h3>
<h4 id="HTML">HTML</h4>
<pre class="brush: html notranslate"><p data-foo="hello">world</p></pre>
<h4 id="CSS">CSS</h4>
<pre class="brush: css highlight[2] notranslate">[data-foo]::before {
content: attr(data-foo) " ";
}</pre>
<h4 id="Result" name="Result">結果</h4>
<p>{{EmbedLiveSample("content_property", "100%", 50)}}</p>
<h3 id="<color>_value" name="<color>_value"><color> 値</h3>
<p>{{SeeCompatTable}}</p>
<div id="color-value">
<h4 id="HTML_2">HTML</h4>
<pre class="brush: html notranslate"><div class="background" data-background="lime">background expected to be red if your browser does not support advanced usage of attr()</div></pre>
<h4 id="CSS_2">CSS</h4>
<div class="hidden">
<pre class="brush: css notranslate">.background {
height: 100vh;
}</pre>
</div>
<pre class="brush: css highlight[6] notranslate">.background {
background-color: red;
}
.background[data-background] {
background-color: attr(data-background color, red);
}</pre>
</div>
<p>{{EmbedLiveSample("color-value", "100%", 50)}}</p>
<h2 id="Specifications" name="Specifications">仕様書</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">仕様書</th>
<th scope="col">状態</th>
<th scope="col">備考</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName("CSS4 Values", "#attr-notation", "attr()")}}</td>
<td>{{Spec2("CSS4 Values")}}</td>
<td>{{CSSxRef("var()")}} のように動作するように変更。 <code>attr()</code> を含むプロパティ値は解析時に有効となり、属性値の検証は計算値になるまで延期されます。</td>
</tr>
<tr>
<td>{{SpecName("CSS3 Values", "#attr-notation", "attr()")}}</td>
<td>{{Spec2("CSS3 Values")}}</td>
<td>
<p>2 つのオプション引数を追加<br>
全プロパティで使用可能<br>
{{CSSxRef("<string>")}} 以外の値が返せるようになった。</p>
これらの変更は実験的であり、ブラウザーの互換性が少なすぎると CR 段階で外される可能性がある</td>
</tr>
<tr>
<td>{{SpecName("CSS2.1", "generate.html#x18", "attr()")}}</td>
<td>{{Spec2("CSS2.1")}}</td>
<td>{{CSSxRef("content")}} プロパティに限定<br>
常に {{CSSxRef("<string>")}} を返す</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>
<p>{{Compat("css.types.attr")}}</p>
<h2 id="See_also" name="See_also">関連情報</h2>
<ul>
<li><a href="/ja/docs/Web/CSS/Attribute_selectors">属性セレクター</a></li>
<li><a href="/ja/docs/Web/HTML/Global_attributes/data-*">HTML <code>data-*</code> 属性</a></li>
<li><a href="/ja/docs/Web/SVG/Attribute/data-*">SVG <code>data-*</code> 属性</a></li>
</ul>
|
