title | slug | l10n | ||
---|---|---|---|---|
<caption>: 表キャプション要素 |
Web/HTML/Element/caption |
|
{{HTMLSidebar}}
<caption>
は HTML の要素で、表のキャプション(またはタイトル)を指定します。
{{EmbedInteractiveExample("pages/tabbed/caption.html", "tabbed-taller")}}
この要素にはグローバル属性があります。
以下の属性は非推奨であり、使用するべきではありません。以下に記述しているのは、既存コードを更新する際の参考や、歴史的な関心としてのためのみです。
-
align
{{deprecated_inline}}-
: この列挙型属性は caption 要素の、自身の指し示す table 要素を基準とした相対的な位置を指定します。以下の値が指定できます。
left
- : キャプションを表の左側に表示します。
top
- : キャプションを表の上側に表示します。
right
- : キャプションを表の右側に表示します。
bottom
- : キャプションを表の下側に表示します。
[!WARNING] この属性は非推奨ですので使用しないでください。{{HTMLElement("caption")}} 要素にスタイルを適用するには、CSS プロパティの {{cssxref("caption-side")}} および {{cssxref("text-align")}} を使用してください。
-
<caption>
要素は親である {{htmlelement("table")}} 要素の最初の子とする必要があります。
<caption>
を持つ <table>
要素が {{HTMLElement("figure")}} 要素の唯一の子孫である場合は、 {{HTMLElement("figcaption")}} 要素を <caption>
の代わりに使用してください。
表の {{cssxref("background-color")}} はキャプションを含みません。両方の背景を同じ色にしたい場合は、background-color
を <caption>
要素にも追加してください。
このシンプルな例は、キャプションを含む票を表します。
<table>
<caption>
Example Caption
</caption>
<tr>
<th>Login</th>
<th>Email</th>
</tr>
<tr>
<td>user1</td>
<td>[email protected]</td>
</tr>
<tr>
<td>user2</td>
<td>[email protected]</td>
</tr>
</table>
caption {
caption-side: top;
}
table {
border-collapse: collapse;
border-spacing: 0px;
}
table,
th,
td {
border: 1px solid black;
}
{{EmbedLiveSample('Example', 650, 100)}}
コンテンツカテゴリー | なし |
---|---|
許可されている内容 | フローコンテンツ |
タグの省略 | 要素の直後に ASCII 空白文字やコメントが続かない場合、終了タグは省略可能です。 |
許可されている親要素 | {{HTMLElement("table")}} 要素で、その最初の子要素としてのみ配置可能。 |
暗黙の ARIA ロール | caption |
許可されている ARIA ロール | 許可されている role なし |
DOM インターフェイス | {{domxref("HTMLTableCaptionElement")}} |
{{Specifications}}
{{Compat}}
-
{{HTMLElement("caption")}} 要素の align 属性 の代替となる CSS プロパティ:
- {{cssxref("text-align")}}, {{cssxref("caption-side")}}