规格表格：格式、规则与示例

规格表格将关于一个主体的事实转化为清晰的标签–值对。读者无需重新阅读产品描述即可找到工作温度，机器也能保留"工作温度"与"−10 至 45 °C"之间的关系，无需猜测哪个数字对应哪个声明。

以上产品名称和数值仅为示意。该结构是生产模式：一个主体，每行一个精确标签，一个带有单位的数值，以及在无法提供事实值时的明确状态标识。

为什么这个元素重要

规格描述性文字迫使读者进行本可避免的重构。试想：“该设备重6.4公斤，可连续输出500瓦，尺寸为280×190×210毫米，可在零下10至45摄氏度范围内运行。“这句话语法正确，但只寻找尺寸的买家必须解析每一个从句。稍后回来检查输出功率时又需要再次解析。表格将标签移至可预测的边缘，将数值移至第二列，减少了记忆负担，使浏览变得可靠。

这种结构对机器同样重要。机器可提取性是指爬虫、搜索系统、助手或下游发布工具保留内容中含义和关系的能力。原生 <table>、<th scope="row"> 和 <td> 标记表明行标题限定了相邻值，从而产生可靠的配对：“可用容量 — 512 Wh”。相同的两个字符串嵌入在促销性句子中则需要语言级别的推理，而一组无关联的 <div> 元素的样式化集合可能暴露视觉对齐关系，但不会暴露数据关系。

可查询并不意味着每个网站都成为数据库。它意味着每个事实都有一个稳定的标签、一个离散的值和可预测的标记，因此读者或系统可以询问一个属性而无需提取整个段落。可比较意味着单独发布的产品可以使用相同的规范标签和单位，使值稍后能够对齐，而无需先规范化"约半千瓦”、“500瓦"和"0.5 kW”。规格表格支持这种后续比较；除非它并排呈现多个主体，否则它本身并非比较。

何时使用

当页面描述一个实体，且读者需要至少三个离散的、已验证的事实时，使用规格表格。典型主体包括产品、软件方案、API、文件格式、设施、车辆、组织、服务包或技术标准。适合的事实具有有界的答案：尺寸、支持的操作系统、连接器类型、响应格式、保修期、法定名称、覆盖区域、版本或已声明的限制。

在表格周围使用散文来解释后果。“最大载荷：18公斤"属于表格；为什么该限制排除了某个特定安装则属于散文。表格应回答"值是什么？"，而周围的解释应回答"为什么它重要？”

近似但不符合的情况很常见：

• 当两个或更多产品必须在共同标准上评判时，使用对比表格 。规格表格只有一个主体；添加多个数值列会改变其用途。
• 当内容是事件序列时，使用时间线。两列表格中的日期不会自动使关系变为时间顺序。
• 当每一行需要几句解释性文字时，使用标题和散文。单元格内的密集段落会阻碍浏览，在窄屏幕上更难以阅读。
• 当列表中只有两个简单的事实时，使用句子或定义列表，除非帖子类型要求已注册的规格表格。表格应创造检索价值，而不是装饰一个小事实。
• 当值持续更新时，将该元素连接到自有数据源并显示检索时间。人工复制的"实时"值一旦漂移就会具有误导性。
• 当文档描述字段名称、类型和验证约束时，使用下方的分组变体；不要将整个数据模型塞入一个散文密集的"详情"单元格中。

元素写作规则 具有优先权：根据段落的用途选择元素，而非根据其标题或外观。如果一个块的工作是展示规格，即使主题可以将相同的词渲染为卡片，它仍然是规格表格。

放置位置

将第一个规格表格放在主体已被识别之后、页面要求读者解释、配置、比较或购买之前。在产品页面上，通常这意味着在简洁的产品描述和关键利益之后，但在详细的功能说明之前。在文档中，将前置条件或协议表格放在依赖它的步骤之前。读者需要在看到值之前知道它们描述什么，但也不应该跨越长篇叙述去检索它们。

如果页面有多个类别，将每个表格放在描述性的 H2 或 H3 下方，例如"物理规格"或"兼容性”。将类别标题保留在表格外部；然后用标题命名精确的主体和范围。在兄弟页面上保持相同的标签顺序，这样读者不必重新学习模式。

不要将规格表格直接放在另一个密集表格、全宽截图或动画轮播旁边。两个相互竞争的网格会形成不清晰的阅读路径，在平板宽度下尤其尴尬。不要在标题和其行之间插入行动号召，不要将脚注放在不相关的组件内，也不要将促销性声明放在数值列中。将标题、表格、状态图例、验证日期和来源说明作为一个有界单元。在引入另一个数据密集型元素之前，先用解释性文字跟随。

结构

标注图片必须标识以下部分：

1. 章节标题： 当页面有多个表格时，命名类别，例如物理或电气规格。
2. 标题： 标识表格的主体和确切范围。它必须在脱离周围段落时仍然有意义。
3. 行标题： 使用规范、无歧义的属性名称。
4. 值： 包含一个事实，而非评论或销售主张。
5. 单位： 除非该值确实无量纲，否则每个数值都应附有单位。
6. 状态值： 明确写出"未知"或"不适用"，而不是留空单元格。
7. 验证日期： 说明可变事实的最后检查时间。
8. 来源说明： 标识值来源的主要系统、文档、测试或所有者。

未知 表示该属性适用，但在验证时没有可信的值可用。不适用 表示该属性的前提不适用于此主体。不可用 又有所不同：表示某项能力或选项缺失。零是测量值或声明值。空白单元格无法传达这些含义中的任何一种，因此不允许使用。

设计示例

每个设计变体都保留原生表格标记、行标题、可见标签、文本值和标题。样式可能会改变密度和分组，但不能将事实变成图片，也不能仅依靠颜色传达含义。

标准两列： 适用于一个主体和三到十二个事实的默认形式。标签占据第一列，值占据第二列。用于产品、公司、方案和服务事实。

分组： 两个或多个短表格按读者任务划分更大的规格集。每个组都有一个标题，每个表格保留自己的标题。不要使用合并的分隔行作为视觉标题，因为它们会使导航和提取变得复杂。

字段参考： 一种文档变体，适用于其含义需要一致的辅助字段（如类型、要求和约束）的属性。第一列使用行标题语义，而每个辅助维度都有列标题。

紧凑移动端： 标签和值自然换行而不减小字号。简单的两列表格应在其容器内重新流动。更宽的字段参考变体可在带标签、可键盘聚焦的区域中滚动；不得使整个页面水平滚动。

参数

以下契约定义了便携式元素。最后一列中的"来源"指出渲染器从哪里获取参数，而非事实主张在何处被研究。

当价格、兼容性、可用性、版本支持、容量或其他值可能发生变化时，请使用 verified。发布日期不能替代它：发布日期说明页面何时发布，而非规格何时被检查。

语法与代码示例

所有实现映射到相同的标题、有序行、状态含义、验证值和来源。便携式指令是规范的撰写形式。

便携式 Markdown 指令

:::spec-table{caption="Northstar Field 500 — core specifications" verified="2026-08-27"}
| Specification | Value |
|---|---|
| Usable capacity | 512 Wh |
| Continuous AC output | 500 W |
| Dimensions (W × H × D) | 280 × 190 × 210 mm |
| Water-resistance rating | Unknown |
| Fuel type | Not applicable |

Status: Unknown = relevant but not verified; Not applicable = cannot apply.

Source: approved product data sheet, revision 4.
:::

Hugo 短代码

Hugo 适配器应仅接受命名参数，并将管道表格主体渲染为语义化表格行。以下符号定义了预期的映射；这并不意味着应在文章任务中创建新的本地短代码。

{{< spec-table caption="Northstar Field 500 — core specifications" verified="2026-08-27" >}}
| Specification | Value |
|---|---|
| Usable capacity | 512 Wh |
| Continuous AC output | 500 W |
| Dimensions (W × H × D) | 280 × 190 × 210 mm |
| Water-resistance rating | Unknown |
| Fuel type | Not applicable |

Status: Unknown = relevant but not verified; Not applicable = cannot apply.

Source: approved product data sheet, revision 4.
{{< /spec-table >}}

渲染器必须输出 <table>、<caption>、<tbody>、<th scope="row"> 和 <td>。字段参考变体还需要带有 scope="col" 表头的 <thead>。它必须精确保留减号、乘号、单位间距和状态文本。

WordPress 区块

<!-- wp:amicited/spec-table {"caption":"Northstar Field 500 — core specifications","verified":"2026-08-27","variant":"standard"} -->
<table>
  <tbody>
    <tr><th scope="row">Usable capacity</th><td>512 Wh</td></tr>
    <tr><th scope="row">Continuous AC output</th><td>500 W</td></tr>
    <tr><th scope="row">Dimensions (W × H × D)</th><td>280 × 190 × 210 mm</td></tr>
    <tr><th scope="row">Water-resistance rating</th><td>Unknown</td></tr>
    <tr><th scope="row">Fuel type</th><td>Not applicable</td></tr>
  </tbody>
</table>
<p class="spec-table__status">Unknown = relevant but not verified; Not applicable = cannot apply.</p>
<p class="spec-table__source">Source: approved product data sheet, revision 4.</p>
<!-- /wp:amicited/spec-table -->

WordPress 实现可以使用可编辑的区块控件而非字面 HTML，但其保存的属性和服务端渲染输出必须保留相同的契约。作者不得使用截图或通用列区块替代。

示例

好的：完整、规范化的产品事实

验证日期： 2026年8月27日。来源： 示意性批准安装表，修订版2。

这样做得好是因为标题标识了一个主体和一个上下文。每个标签命名了一个可测试的属性，范围保留了单位，尺寸没有混合系统，最大功率与典型功率有所区分。“不适用"是合理的，因为有线传感器没有可更换的电池；它没有隐藏未知的电池规格。该表格可由人浏览、通过行标题导航，或转换为离散的属性–值对。

差的：模糊的伪数据

这个差的表格看起来有组织，但未提供可靠的数据。“电源"可能指供电电压或功耗，而"低"不可衡量。线缆长度缺少单位。温度行未命名是摄氏度还是华氏度，且似乎将范围与度符号混合。“坚固耐用"是促销性语言，而非防护等级。空白的电池单元格未说明该事实是未知、不相关、为零还是意外遗漏。兼容性声明将一个未定义的人群和安装判断捆绑在一个单元格中。

修复方法是将宽泛的标签拆分为规范的属性，从命名的主要来源获取值，为每个测量值添加单位，并用正确的状态替换空白。如果来源未说明防护等级，请写"未知”；不要将营销语言转化为编造的技术值。

Schema 标记与无障碍

没有通用的规格表格的 Schema.org 类型。即使表格没有产生 JSON-LD，它仍然是具有价值的语义化 HTML。当封闭页面表示一个符合条件的实体时，仅将精确的、已验证的事实映射到支持的属性：例如，产品的 sku、weight、width、height、depth、material 或适当的 additionalProperty 条目。组织事实可映射到法定名称或地址等属性。可见表格和结构化数据必须一致，使用相同的单位，并来自相同的来源。不要因为存在某一行而编造评分、优惠、标识符或 Schema 属性。

无障碍始于真实的标记。为表格添加描述性的 <caption>。为每个规格标签使用 <th scope="row">；字段参考变体还需在 <thead> 中使用 <th scope="col">。保持源代码中的阅读顺序逻辑正确，而不仅仅是在屏幕上。不要使用空白单元格、合并单元格、仅图标状态、仅颜色分组或仅作为值位置的工具提示。当目标受众可能不熟悉时，AC、DC、IP 等缩略语应在附近的散文中加以展开。

一个基本的两列表格应尽可能换行而非滚动。当较宽的表格需要水平滚动时，将其包含在具有无障碍标签和 tabindex="0" 的区域中，保留可见的键盘焦点指示器，并且永远不要以在高缩放时覆盖值的方式锁定第一列。在 200% 缩放、键盘导航和样式禁用的情况下进行测试；标签–值关系必须在所有三种情况下都存在。

写作规则

这些规则保护检索和比较功能，因此精确性优先于简洁性：

• 每个表格使用 3–12 行。按读者任务（物理、电气、兼容性、商业）拆分较长的集合，而不是创建一堵无差别的事实墙。
• 标签尽可能保持在 1–6 个词。当含义发生变化时，使用限定词如"最大”、“典型”、“已安装"或"每用户”。
• 普通值保持在一行以内，不超过 12 个词。将解释、例外和建议移至相邻的散文或直接关联的注释中。
• 每个表格使用一个计量系统，除非受众确实需要两者。当两者都需要时，在每一适用的行中首先呈现主要值，括号内显示换算值。
• 在每个数值测量值旁边放置单位：512 Wh、3 m、45 °C。切勿依赖标题仅为某些行提供单位。
• 在兄弟页面上规范化等效的属性。选择一个标签和一个单位——例如以公斤为单位的"重量”——并且不要在没有记录原因的情况下与"质量"、磅或模糊短语交替使用。
• 使用准确的状态词：Unknown、Not applicable 或 Not available。当出现多个状态时，一次性定义它们。切勿使用破折号、空白单元格、TBC、问号或颜色来暗示状态。
• 使用事实性和中性的语气。值可能是有利的，但"惊人"、“超快”、“同类最佳"和"慷慨"等词语是结论，而非规格。
• 切勿在值单元格中放置行动号召、推荐信、段落式的销售文案、未经解释的评分、无根据的比较或装饰性图片。
• 对于可变或外部断言的值，说明来源和确切的验证日期。如果所有权不明确，则该表格尚未准备好发布。

使用它的帖子类型

postTypes 前置元数据字段驱动以下批准的用途。列入意味着该帖子类型可能需要或受益于该元素；并不意味着每个页面都必须编造三个事实来满足布局。

QA 检查清单

• 表格描述一个清晰标识的主体；多个选项未被伪装成规格表格。
• 标题同时命名了主体和表格的范围。
• 每个属性使用精确、规范的标签，每个单元格包含一个值。
• 数值包含一致的单位、限定词、范围和维度。
• 没有空白单元格；Unknown、Not applicable 和 Not available 仅在其定义含义下使用。
• 声明与命名的主要来源匹配，可变事实显示确切的验证日期。
• 发布输出使用原生 <table>、<caption>、行标题和数据单元格，而非图片或视觉网格。
• 字段参考变体包含列标题并保留所有表头关系。
• 表格在窄宽度、200% 缩放、键盘导航和样式禁用的情况下正常工作。
• 颜色、图标、缩略语和工具提示从来不是理解值的唯一方式。
• 可见事实与任何符合条件的 Schema.org 属性完全一致。
• 促销声明、解释、行动号召和长篇散文位于表格之外。
• 该元素遵循手册的优先级规则，且所选帖子类型在其内容契约中包含了该元素。