# 表格

你可以在 GitBook 页面中添加表格，以更好地组织信息。你可以在下面的示例表格中查看可实现效果：

<table data-full-width="false"><thead><tr><th>公司</th><th>状态<select><option value="36bef47f343d4588bc43db3e5c701796" label="进行中" color="blue"></option></select></th><th>联系</th><th>经常性月收入（MRR）</th><th data-hidden>联系</th><th data-hidden>经常性月收入（MRR）</th><th data-hidden>状态<select><option value="3e7a52c673ec4a01992566d18271f7a5" label="进行中" color="blue"></option><option value="2362fd3eafc7476fb8646ac754f34b72" label="已完成" color="blue"></option></select></th></tr></thead><tbody><tr><td><strong>Ace AI</strong> – 设计</td><td><span data-option="36bef47f343d4588bc43db3e5c701796">进行中</span></td><td><a href="mailto:noreply@gitbook.com">rena@ace.ai</a></td><td>$450</td><td><a href="mailto:noreply@gitbook.com">rena@ace.ai</a></td><td>$420</td><td><span data-option="3e7a52c673ec4a01992566d18271f7a5">进行中</span></td></tr><tr><td><strong>Discrete Data</strong> – API</td><td><span data-option="36bef47f343d4588bc43db3e5c701796">进行中</span></td><td><a href="mailto:noreply@gitbook.com">dave@dd.inc</a></td><td>$100</td><td><a href="mailto:noreply@gitbook.com">dave@dd.inc</a></td><td>$69</td><td></td></tr><tr><td><strong>Example Co</strong></td><td></td><td><a href="mailto:pete@example.com">pete@example.com</a></td><td>$50</td><td></td><td></td><td></td></tr></tbody></table>

### 表格块选项

当你打开表格块左侧的“选项”菜单时，你会看到多个选项，可用于更改外观并管理表格中的数据：

* **表格/卡片：** 选择将数据显示为表格块或 [卡片块](https://gitbook-v2-az4xct27g-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/blocks/cards)。GitBook 会使用相同的数据填充这两种块，因此你可以根据想要的外观和设计在它们之间切换。
* **添加列：** 在表格右侧添加一列新列。你可以使用菜单选择列类型，或者直接点击 **添加列** 来添加文本列。
* **插入行：** 在表格底部添加一行新行。
* **显示表头：** 隐藏或显示表格顶部的标题行。
* **冻结表头：** 在你滚动下方行时，让表格顶部行始终保持可见。这对于较大的表格很有用，因为你希望列标题始终可见。
* **冻结第一列：** 在你横向滚动右侧各列时，让表格最左侧的列始终保持可见。这对于超出页面宽度的较宽表格很有用，因为你希望行标签或标识符始终可见。
* **重置列宽：** 如果你更改过列宽，这会将它们全部重置为相等。
* **可见列：** 选择哪些列显示，哪些列隐藏。如果表格中有隐藏列，可以在此菜单中将它们重新显示。
* **全宽：** 使表格占据窗口的全宽。这对于包含很多列的表格非常有用。
* **删除：** 删除表格块及其所有内容。

### 更改列类型

根据你想要显示的数据，可以为表格列设置不同的数据类型。这些类型会为该列中的每个单元格添加格式、装饰或限制：

* **文本：** 标准文本列，支持标准格式。
* **数字：** 数字列，可带或不带小数位。
* **复选框：** 每一行都有一个可勾选或取消勾选的复选框。
* **选择：** 你可以从一组可选项中选择数据，这些选项可通过打开 **列选项** 菜单并选择 **管理选项**来定义。这可以是单选或多选。
* **用户：** 你可以添加组织成员的姓名和头像。这可以是单选或多选。
* **文件：** 你可以引用空间中的文件。在填充该列的单元格时，你可以上传新文件。
* **评分：** 星级评分。你可以通过打开 **列选项** 菜单并选择 **最大值**.

使用 **列选项** 菜单更改列类型。更改列类型时，你会看到一个提示，要求你确认更改，因为此操作可能会删除或破坏列数据。

### 调整列宽

将鼠标悬停在列边缘并拖动即可调整大小。光标上方会显示像素计数，帮助你设置一致的列宽。

GitBook 会将列宽存储为总体宽度的百分比，这使得可以根据表格总宽度进行相对调整。

### 可滚动表格

比编辑器容器更宽的表格可以水平滚动。

### 列选项

要重新排序列，请点击并拖动 <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FPnnI41SqLSaKBNwT98fW%2Factions-horizontal.svg?alt=media&#x26;token=99754200-a354-4ffe-931e-aa6322ea7395" alt="The table drag handle icon in GitBook"></picture> 你想移动的列顶部的拖拽把手。

你可以通过点击 **添加列** 按钮来添加新列，该按钮会在你悬停于表格右边缘时出现。

在 **列选项** 菜单中，你还可以开启或关闭自动调整大小、在右侧添加新列、隐藏该列或删除该列。

### 行选项

将鼠标悬停在该行上，然后点击 **行选项** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Row options menu icon in GitBook"></picture> 它左侧出现的按钮以打开 **行选项** 菜单。你会看到多个选项：

* **打开行：** 在一个模态窗口中打开该行，显示其全部数据。在这里你可以快速更改行类型、编辑数据，并查看隐藏列中的数据。
* **在上方/下方插入：** 在当前选中的行上方或下方添加一行新行。
* **添加列：** 在表格右侧添加一列新列。
* **删除行：** 永久移除表格中该行的所有数据。

### 表格中的图片

当你点击表格单元格时，可以按 / 键插入图片。图片不能添加到表格的表头行。

### 在 Markdown 中的表示

```markdown
# 表格

|   |   |   |
| - | - | - |
|   |   |   |
|   |   |   |
|   |   |   |
```

<details>

<summary>我可以在 GitBook 中创建嵌套表格吗？</summary>

GitBook 不支持嵌套表格。为了确保文档易于编写、可靠渲染，并且对所有用户都可访问，GitBook 保持表格扁平化。

一旦表格位于另一个表格单元格中，它就会变得难以编辑、调整大小、导航，或在不同设备上保持一致的格式。

嵌套表格还会给底层文档结构带来很大的复杂性，通常会破坏清晰的语义，并导致诸如 Git Sync 等功能出现不可预测的行为。

</details>
