表格

表格通过在清晰的结构中呈现复杂信息，使其更易于理解。

表格的目的是提供一种易于快速浏览的内容体验。

将表格用于：

• 数据与值的简单映射
• 带示例的事务分类
• 具有不同属性的事务集合

表格中的每个单元格包含的内容不应超过一句话。

我们在文档中使用标准的 Markdown 表格。

| Category | Range |
| ---- | ---- |
| **Not computed** | Bot scores of 0. |
| **Automated** | Bot scores of 1. |
| **Likely automated** | Bot scores of 2 through 29. |
| **Likely human** | Bot scores of 30 through 99. |
| **Verified bot** | Non-malicious automated traffic (used to power search engines and other applications). |

使用表格时：

• 检查表格对桌面和移动端用户是否都合适。
• 将表格限制为最多三列（如果信息非常精简，则最多四列）。
• 避免使用长句或过于密集的信息，这会违背使用表格展示的初衷。

• 使用描述表格用途的完整句子来引入表格，因为并非所有屏幕阅读器都会预先宣告表格。引入句可以以冒号或句号结尾；如果它紧邻表格上方，通常使用冒号，如果引入句和表格之间还有其他内容（例如提示段落），则通常使用句号。

• 请勿合并单元格。合并单元格会破坏屏幕阅读器的导航，并使内容更难被 AI 系统解析。
• 按逻辑顺序对行进行排序。如果不存在逻辑顺序，请按字母顺序排序。

使用描述表格用途的完整句子来引入表格，因为并非所有屏幕阅读器都会预先宣告表格。引入句可以以冒号或句号结尾；如果它紧邻表格上方，通常使用冒号，如果引入句和表格之间还有其他内容（例如提示段落），则通常使用句号。

在引用表格时，请使用诸如“下表”或“上表”之类的短语。请勿将表格放在句子的中间。

• 列标题使用句首字母大写格式。
• 编写清晰描述列内容的简明标题。
• 列标题端请勿以标点符号（包括句号、省略号或冒号）结尾。
• 仅为第一行使用标题。当第一列的值作为行标签时，请将其加粗。

• 将每个表格直接放在介绍它的句子之后。
• 请勿将表格放在编号程序的中间。如果步骤需要表格数据，请将表格紧放在该步骤之后，而不是放在两个步骤之间。
• 如果表格有脚注，请将其紧放在表格之后。

如果页面仅包含一个表格，则不需要标题。将表格放置在引用它的文本相邻位置。

如果页面在很近的距离内包含多个表格，请为每个表格添加标题，以便读者（以及 AI 系统）能够区分它们。在 Markdown 中，将标题作为加粗行直接放在表格上方。在 HTML 中，使用 caption 元素作为 table 元素的第一个子元素。

以 Table NUMBER.（表格 编号.）形式的数字开始标题，后跟简短描述。使用句首字母大写。请勿在标题末尾放置句号。

当在正文中引用带有标题的表格时，请按数字引用——例如，“如表 2 所示（as shown in table 2）”。除非位于句首，否则不要将“table”大写。

Markdown 示例：

**Table 1.** Supported DNS record types

| Type | Description |
| --- | --- |
| A | Maps a domain to an IPv4 address |
| AAAA | Maps a domain to an IPv6 address |

HTML 示例：

<table>
  <caption><b>Table 1.</b> Supported DNS record types</caption>
  <thead>
    <tr>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>A</td>
      <td>Maps a domain to an IPv4 address</td>
    </tr>
  </tbody>
</table>

如果您的信息不符合指南，请考虑使用以下呈现方法：

• 列表
• 子章节
• 标签页（Tabs）
• 详细信息（Details）

如指南所述，我们通常在文档中避免使用大型表格。

不过，如果您有特殊的用例，请使用 {{</*table-wrap*/>}} 短代码使您的表格具有响应式并可滚动。

{{</*table-wrap*/>}}

| Header 1 | Header 2 | Header 3 | Header 4 |
| --- | --- | --- | --- |
| test | test | test | test |

{{</*/table-wrap*/>}}