规范表格
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 取代。它不再处于成为标准的轨道上。