规范表格

MDN 上的每个参考页面都应提供有关定义该 API 或技术的规范或规范的信息。本文演示了这些表格的外观并解释了如何添加它们。

规范部分定义类似于 兼容性表格 定义,通常从相同的数据源生成,并且通常在页面中紧挨着兼容性表格出现。

标准规范表格

标准规范部分应如下所示

md
## Specifications

{{Specifications}}

{{Specifications}} 宏根据页面前置信息中的值生成规范表格。

默认情况下,使用 browser-compat 键中的值。每个值都引用了特定功能及其关联的兼容性和规范信息,位于 browser-compat-data 存储库中。例如,text-align 页面具有以下键,它用于获取关联的规范信息。

yaml
browser-compat: css.property.text-align

某些功能未在上述存储库中维护。在这些情况下,可以使用 spec-urls 键将规范信息添加到页面前置信息中。例如,aria-atomic 属性具有以下前置信息键

yaml
spec-urls: https://w3c.github.io/aria/#aria-atomic

上面 css.property.text-align 键的规范表格以表格形式呈现,如下所示

规范

规范
CSS 逻辑属性和值级别 1
# text-align
CSS 文本模块级别 3
# text-align-property

非标准功能

记录非标准功能(尤其是已从标准化轨道中移除的功能)时,不要调用 {{Specifications}} 宏。

相反,请尝试提供有关功能状态和可能的替代方案的信息。例如

  • 此方法不再处于标准化轨道。出于兼容性目的保留它。请改用 *其他方法*。
  • 此方法最初是 DOM 级别 2 遍历和范围 的一部分,但在当前 DOM 规范中不存在。此功能不再处于成为标准的轨道上。
  • 此事件处理程序是旧 WebVR API 的一部分,该 API 已被 WebXR 设备 API 取代。它不再处于成为标准的轨道上。