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
|
---
title: '<caption>: 表キャプション要素'
slug: Web/HTML/Element/caption
tags:
- Element
- HTML
- HTML Tables
- HTML tabular data
- Reference
- Table Captions
- Table Titles
- Tables
- Web
- caption
translation_of: Web/HTML/Element/caption
---
<div>{{HTMLRef}}</div>
<p><span class="seoSummary"><strong>HTML の <code><caption></code> 要素</strong>は、表のキャプション (またはタイトル) を指定します。</span></p>
<div>{{EmbedInteractiveExample("pages/tabbed/caption.html", "tabbed-taller")}}</div>
<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p>
<table class="properties">
<tbody>
<tr>
<th scope="row"><a href="/ja/docs/Web/HTML/Content_categories">コンテンツカテゴリ</a></th>
<td>なし</td>
</tr>
<tr>
<th scope="row">許可されている内容</th>
<td><a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a></td>
</tr>
<tr>
<th scope="row">タグの省略</th>
<td>要素の直後に ASCII 空白文字やコメントが続かない場合、終了タグは省略可能です。</td>
</tr>
<tr>
<th scope="row">許可されている親要素</th>
<td>{{HTMLElement("table")}} 要素。table 要素の最初の子要素としてのみ配置可能。</td>
</tr>
<tr>
<th scope="row">暗黙の ARIA ロール</th>
<td><a href="https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role">対応するロールなし</a></td>
</tr>
<tr>
<th scope="row">許可されている ARIA ロール</th>
<td>許可されている <code>role</code> なし</td>
</tr>
<tr>
<th scope="row">DOM インターフェイス</th>
<td>{{domxref("HTMLTableCaptionElement")}}</td>
</tr>
</tbody>
</table>
<h2 id="Attributes" name="Attributes">属性</h2>
<p>この要素は <a href="/ja/docs/Web/HTML/Global_attributes">グローバル属性</a> を持ちます。</p>
<h3 id="Deprecated_attributes" name="Deprecated_attributes">非推奨の属性</h3>
<p>以下の属性は非推奨であり、使用するべきではありません。以下に記述しているのは、既存コードを更新する際の参考や、歴史的な関心としてのためのみです。</p>
<dl>
<dt>{{htmlattrdef("align")}} {{deprecated_inline}}</dt>
<dd>この列挙属性は caption 要素の、自身の指し示す table 要素を基準とした相対的な位置を指定します。以下の値を指定できます。
<dl>
<dt><code>left</code></dt>
<dd>キャプションを表の左側に表示します。</dd>
<dt><code>top</code></dt>
<dd>キャプションを表の上側に表示します。</dd>
<dt><code>right</code></dt>
<dd>キャプションを表の右側に表示します。</dd>
<dt><code>bottom</code></dt>
<dd>キャプションを表の下側に表示します。</dd>
</dl>
<div class="note"><strong>使用上の注意:</strong> この属性は非推奨ですので使用しないでください。 {{HTMLElement("caption")}} 要素にスタイルを適用するには、 <a href="/ja/docs/Web/CSS">CSS</a> プロパティの {{cssxref("caption-side")}} および {{cssxref("text-align")}} を使用してください。</div>
</dd>
</dl>
<h2 id="Usage_notes" name="Usage_notes">使用上の注意</h2>
<p><code><caption></code> 要素は親である {{htmlelement("table")}} 要素の最初の子としてください。</p>
<p><code><table></code> 要素が {{HTMLElement("figure")}} 要素の唯一の子孫である場合は、 {{HTMLElement("figcaption")}} 要素を <code><caption></code> の代わりに使用してください。</p>
<h2 id="Example" name="Example">例</h2>
<p>このシンプルな例は、キャプションを含む票を表します。</p>
<pre class="brush: html notranslate"><table>
<caption>Example Caption</caption>
<tr>
<th>Login</th>
<th>Email</th>
</tr>
<tr>
<td>user1</td>
<td>user1@sample.com</td>
</tr>
<tr>
<td>user2</td>
<td>user2@sample.com</td>
</tr>
</table></pre>
<div class="hidden">
<pre class="brush: css notranslate">caption {
caption-side: top;
align: right;
}
table {
border-collapse: collapse;
border-spacing: 0px;
}
table, th, td {
border: 1px solid black;
}
</pre>
</div>
<p>{{EmbedLiveSample('Example', 650, 100)}}</p>
<p><code>table {background: red;}</code> ではキャプションは変更されません。そのためには <code>display: block</code> が必要です。</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('HTML WHATWG', 'tables.html#the-caption-element', '<caption>')}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td></td>
</tr>
<tr>
<td>{{SpecName('HTML5 W3C', 'tabular-data.html#the-caption-element', '<caption>')}}</td>
<td>{{Spec2('HTML5 W3C')}}</td>
<td></td>
</tr>
<tr>
<td>{{SpecName('HTML4.01', 'struct/tables.html#h-11.2.2', '<caption>')}}</td>
<td>{{Spec2('HTML4.01')}}</td>
<td></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("html.elements.caption")}}</p>
<h2 id="See_also" name="See_also">関連情報</h2>
<ul>
<li>{{HTMLElement("caption")}} 要素の align 属性 の代替となる CSS プロパティ:
<ul>
<li>{{cssxref("text-align")}}, {{cssxref("caption-side")}}</li>
</ul>
</li>
</ul>
|