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.

句法

/* Directional values */
caption-side: top;
caption-side: bottom;
/* Warning: non-standard values */
caption-side: left;
caption-side: right;
caption-side: top-outside;
caption-side: bottom-outside;
/* Global values */
caption-side: inherit;
caption-side: initial;
caption-side: unset;
					

caption-side property is specified as one of the keyword values listed below.

top

The caption box should be positioned above the table.

bottom

The caption box should be positioned below the table.

left

The caption box should be positioned on the left side of the table.

This value was proposed for CSS 2, but removed from the final CSS 2.1 specification. It is non-standard.

right

The caption box should be positioned on the right side of the table.

This value was proposed for CSS 2, but removed from the final CSS 2.1 specification. It is non-standard.

top-outside

The caption box should be positioned above the table, while the width and horizontal alignment behavior are not bound to the table's horizontal layout.

The CSS 2.1 specification notes that the CSS 2 specification described a different behavior for the top value, which will be reintroduced by this value in a future specification.
bottom-outside

The caption box should be positioned below the table, while the width and horizontal alignment behavior are not bound to the table's horizontal layout.

The CSS 2.1 specification notes that the CSS 2 specification described a different behavior for the bottom value, which will be reintroduced by this value in a future specification.

形式定义

初始值 top
适用于 table-caption elements
继承 yes
计算值 如指定
动画类型 discrete

形式句法

top | bottom | block-start | block-end | inline-start | inline-end
					

范例

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;
}
					

结果

规范

规范 状态 注释
CSS Logical Properties and Values Level 1
The definition of 'caption-side' in that specification.
编者草案 Defines the top and bottom values as relative to the writing-mode 值。
CSS Level 2 (Revision 1)
The definition of 'caption-side' in that specification.
推荐 初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
caption-side Chrome 完整支持 1 Edge 完整支持 12 Firefox 完整支持 1 IE 完整支持 8 Opera 完整支持 4 Safari 完整支持 1 WebView Android 完整支持 ≤37 Chrome Android 完整支持 18 Firefox Android 完整支持 4 Opera Android 完整支持 14 Safari iOS 完整支持 1 Samsung Internet Android 完整支持 1.0
Non-standard values left , right , top-outside ,和 bottom-outside 非标 Chrome 不支持 No Edge 不支持 No Firefox 完整支持 1 IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 不支持 No Chrome Android 不支持 No Firefox Android 完整支持 4 Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 不支持 No
top and bottom are relative to the writing-mode value Chrome 不支持 No Edge 不支持 No Firefox 完整支持 42 IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 不支持 No Chrome Android 不支持 No Firefox Android 完整支持 42 Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 不支持 No

图例

完整支持

完整支持

不支持

不支持

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

元数据

  • 最后修改: