属性 描述 值 描述 备注

caption

定义一个表格的标题标签

用户定义的

cols

以逗号分隔的列指定符

指定符

指定列数以及每列的分配比例和默认格式。详见 add-columns.html 以获取详情

format

表格内容的数据格式

psv

单元格由 separator 分隔（默认为 |）（又称前缀分隔值）

dsv

单元格由冒号 (:) 分隔（又称分隔符分隔值）

csv

单元格由逗号 (,) 分隔（又称逗号分隔值）

tsv

单元格由制表符分隔（即制表符分隔值）

separator

用于分隔单元格的字符

|

顶级表格的默认值

!

嵌套表格的默认值

用户定义的

任意单个字符或 \t 用于制表符（例如，¦ 或 %）。 理想情况下是单元格内容中未出现的字符。

frame

绘制表格边框

all

四边都有边框（默认）

ends

上下顶端有边框

none

没有边框

sides

左右两边有边框

grid

在行列之间绘制边界线

all

在每个单元格周围绘制边界线（默认）

cols

在列之间绘制边界线

rows

在行之间绘制边界线

none

没有边界线

stripes

控制行阴影（通过背景颜色）

none

没有行会被阴影（默认）

even

偶数行被阴影

odd

奇数行被阴影

hover

鼠标悬浮的行被阴影（仅限HTML）

all

所有行被阴影

align

水平对齐宽度受限的表格

left

对齐到页面的左侧（默认）

Asciidoctor不认可。 要对齐表格，请使用对齐角色（例如，[role=center] 或 [.center]）。 对齐角色适用于HTML和PDF输出。 对齐角色和 float 属性是相互排斥的。

right

对齐到页面的右侧

center

水平对齐到页面的中央

float

将表格浮动到页面的指定一侧

left

将表格浮动到页面的左侧（默认）

仅适用于HTML输出。 必须与表格的 width 属性一起使用才能生效。 float 和 align 属性是相互排斥的。

right

将表格浮动到页面的右侧

halign

水平对齐表格中所有单元格的内容

left

将单元格内容对齐到左侧（默认）

Asciidoctor不认可。 相反，定义使用列或单元格指定符（例如，3*>），它们优先于此值。

right

将单元格内容对齐到右侧

center

将内容对齐到单元格中央

valign

垂直对齐表格中所有单元格的内容

top

将单元格内容对齐到单元格顶部（默认）

Asciidoctor不认可。 相反，定义使用列或单元格指定符（例如，3*.>），它们优先于此值。

bottom

将单元格内容对齐到单元格底部

middle

将单元格内容对齐到单元格中央

orientation

旋转表格

landscape

逆时针旋转90度

等同于设置旋转选项，这是首选。 仅限DocBook。

options

逗号分隔的选项名称列表

header

将首行升级为表头

默认忽略表头和表尾行

footer

将最后一行升级为表尾

breakable

允许表格跨页分割（默认）

相互排斥。 仅限DocBook（特别是用于生成PDF输出）。

unbreakable

阻止表格跨页分割

autowidth

禁用明确的列宽（忽略 cols 属性中的分配比例）

rotate

以横向格式打印表格

等同于将方向设置为横向。 仅限DocBook。

role

逗号分隔的角色名称列表

left

将表格浮动到左边距

角色是指定宽度受限表格对齐的首选方式。 可能通过使用角色缩写来指定（例如，[.center]）。

right

将表格浮动到右侧

center

将表格对齐到中央

stretch

将自动宽度表格拉伸到页面的宽度

width

表格宽度相对于可用页面宽度

用户定义的值

一种介于0%和100%之间的百分比值