一个表格是一个有界限的块,可以有可选的自定义设置,例如ID和标题,以及特定于表格的属性、选项和角色。但是,最基本的,一个表格只需要列和行。

在这个页面上,你将学到:

  • ✓ 如何设置AsciiDoc表格块及其属性列表。

  • ✓ 如何使用 cols 属性向表格中添加列。

  • ✓ 如何向表格中添加单元格并将它们排列成行。

  • ✓ 如何指定一行作为表格的标题行。

创建一个有两列三行的表格

设置一个有两列的表格 中,我们将为 cols 属性分配一个列指定符列表。列指定符代表一个列。

设置一个有两列的表格
|=== (1)
[cols="1,1"] (2) (3)
  1. 在新的一行,创建一个属性列表。 设置 cols 属性,后面跟着等号 (=)。

  2. 将一个由逗号分隔的列说明符列表,用双引号 (") 包围分配给 cols。 每个列说明符代表一列。

  3. 在属性列表的紧接着的行,输入表格开始的界定符。 一个表格界定符是一个垂直的竖杠后跟三个等号 (|===)。 这个界定符开始了表格块。

设置一个有两列的表格 中的表格将包含两列,因为分配给 cols 的列表中有两个逗号分隔的条目。 列表中的每个条目被称为列说明符。 一个[.term]*列说明符*代表一列以及分配给该列的宽度、对齐和样式属性。 当每个列说明符是相同的数字时,在本例中为整数 1,所有列的宽度将是相同的。 设置一个有两列的表格 中的每个列的宽度将是相同的,无论它们包含多少内容。

接下来,让我们为表格添加三行。 每行具有相同数量的单元格。 由于 为表格添加三行 中的表格有两列,每行将包含两个单元格。 一个单元开始于一个垂直的竖杠 (|)。

为表格添加三行
[cols="1,1"]
|===
|第1列第1行的单元格 <.> |第1列第2行的单元格 <.> <.> |第2列第1行的单元格 |第2列第2行的单元格

|Cell in column 1, row 3 |Cell in column 2, row 3 (1)
|=== (2)

要创建一个新单元格,请按下 kbd:[Shift+|]。 在竖线(|)之后,输入你希望在该单元格中显示的内容。 在新的一行中,用 | 开始另一个单元格。 每一个连续的单元格将被放置在行中连续的、分开的列中。 行与行之间由一个或多个空行隔开。 当你完成向表格中添加单元格后,按下 kbd:[Enter] 键进入新的一行。 输入闭合界定符(|===)来结束表格块。

提示:建议每个单元格起始于新的一行以及用空行分隔各行这只是一种风格选择。您可以输入多个单元格或者在同一行上输入整行的单元格[xref:add-cells-and-rows.adoc],因为处理器每次遇到垂直线(|)时都会创建一个新单元格。

为表格添加三行中的表格如下所示。 它包含两列和三行文本,这些文本的位置和样式使用默认的对齐方式、样式、边框和宽度属性值。

[cols="1,1"]

Cell in column 1, row 1

Cell in column 2, row 1

Cell in column 1, row 2

Cell in column 2, row 2

Cell in column 1, row 3

Cell in column 2, row 3

除了使用cols属性外,你还可以通过列乘数表格的第一行来指定列数。然而,如果要自定义列的宽度对齐样式,则必须要有`cols`属性。

在表格中添加标题行

让我们在在表格中添加标题行中为表格添加一个标题行。你可以通过在表格开始分隔符后直接输入的第一行中的所有单元,隐式地将第一行标识为标题行。

在表格中添加标题行
|===
[cols="1,1"]
|Cell in column 1, header row |Cell in column 2, header row (1)
(2)
|Cell in column 1, row 2
|Cell in column 2, row 2

|Cell in column 1, row 3
|Cell in column 2, row 3

|Cell in column 1, row 4
|Cell in column 2, row 4
|===

在开头的定界符(|===)后面直接的一行中,将首行的所有单元格内容输入在同一行。 在标题行下面直接的一行留空。

表格来自在表格中添加标题行,如下所示。

[cols="1,1"]

Cell in column 1, header row

Cell in column 2, header row

Cell in column 1, row 2

Cell in column 2, row 2

Cell in column 1, row 3

Cell in column 2, row 3

Cell in column 1, row 4

Cell in column 2, row 4

一个标题行也可以通过为options属性分配header来识别。