caption-side
The caption-side
CSS property puts the content of a table's <caption>
on the specified side. The values are relative to the writing-mode
of the table.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
/* Directional values */
caption-side: top;
caption-side: bottom;
/* Logical values */
caption-side: block-start;
caption-side: block-end;
caption-side: inline-start;
caption-side: inline-end;
/* Global values */
caption-side: inherit;
caption-side: initial;
caption-side: unset;
The caption-side
property is specified as one of the keyword values listed below.
Values
top
- The caption box should be positioned above the table.
bottom
- The caption box should be positioned below the table.
block-start
- The caption box should be positioned at the block start edge of the table.
block-end
- The caption box should be positioned at the block end edge of the table.
inline-start
- The caption box should be positioned at the inline start edge of the table.
inline-end
- The caption box should be positioned at the inline end edge of the table.
Formal definition
Initial value | top |
---|---|
Applies to | table-caption elements |
Inherited | yes |
Computed value | as specified |
Animation type | discrete |
Formal syntax
Examples
Setting captions above and below
HTML
<table class="top">
<caption>Caption ABOVE the table</caption>
<tr>
<td>Some data</td>
<td>Some more data</td>
</tr>
</table>
<br>
<table class="bottom">
<caption>Caption BELOW the table</caption>
<tr>
<td>Some data</td>
<td>Some more data</td>
</tr>
</table>
CSS
.top caption {
caption-side: top;
}
.bottom caption {
caption-side: bottom;
}
table {
border: 1px solid red;
}
td {
border: 1px solid blue;
}
Result
Specifications
Specification | Status | Comment |
---|---|---|
CSS Logical Properties and Values Level 1 The definition of 'caption-side' in that specification. |
Editor's Draft | Defines the top and bottom values as relative to the writing-mode value. |
CSS Level 2 (Revision 1) The definition of 'caption-side' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
BCD tables only load in the browser