caption-side

CSS caption-side 属性会将表格的标题<caption> 放到规定的位置。但是具体显示的位置与表格的 writing-mode 属性值有关。

语法

 caption-side 属性的取值必须是下面所列值中的一个。

CSS

/* 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;

取值

top
标题会出现在表格的上方。
bottom
标题会出现在表格的下方。
left
标题会出现在表格的左侧。
在CSS 2 阶段,这个值被建议加入到规范中,但是在在最终的CSS 2.1 规范中被移除。它是非标准属性。
right
标题会出现在表格的右侧。
在CSS 2 阶段,这个值被建议加入到规范中,但是在在最终的CSS 2.1 规范中被移除。它是非标准属性。
top-outside
标题会被放置在表格上方,但是标题的宽度和水平对齐方式不受表格水平布局的约束。
在CSS 2.1 规范中提到:CSS 2 规范中对 top 值产生的效果有不同的定义,在未来可能会重新定义这个值产生的影响效果。
bottom-outside
标题会被放置在表格下方,但是标题的宽度和水平对齐方式不受表格水平布局的约束。
在CSS 2.1 规范中提到:CSS 2 规范中对 top 值产生的效果有不同的定义,在未来可能会重新定义这个值产生的影响效果。

示例

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
caption-side
Editor's Draft

定义和css定义的书写模式值相关的顶部及底部的值。

CSS Level 2 (Revision 1)
caption-side
Recommendation 初始版本。

浏览器兼容性

BCD tables only load in the browser