规范表格
Baseline 广泛可用 *
MDN 上的每个参考页面都应提供有关定义该 API 或技术的规范的信息。本文演示了这些表的外观以及如何添加它们。
规范部分的定义与兼容性表的定义相似,通常来自相同的数据源,并且通常出现在页面中紧靠其前方的位置。
标准规范表
标准规范部分的外观应如下所示
md
## Specifications
{{Specifications}}
{{Specifications}} 宏根据页面 front-matter 中的值生成规范表。
默认情况下,使用browser-compat键中的值。每个值都引用一个特定的功能及其在browser-compat-data存储库中的相关兼容性和规范信息。例如,text-align页面具有以下键,用于获取相关的规范信息。
yaml
browser-compat: css.property.text-align
有些功能不在上述存储库中维护。在这种情况下,可以通过spec-urls键将规范信息添加到页面 front matter。例如,aria-atomic属性具有 front matter 键
yaml
spec-urls: https://w3c.github.io/aria/#aria-atomic
上面css.property.text-align键的规范表将呈现为如下表格
规范
| 规范 |
|---|
| CSS 逻辑属性和值第 1 级 # text-align |
| CSS Text Module Level 3 # text-align-property |
非标准功能
在记录非标准功能时,特别是那些已从标准化轨道中移除的功能,请勿调用{{Specifications}}宏。
相反,请尝试提供有关功能状态和可能替代方案的信息。示例
- 此方法已不再处于标准化轨道上。为保持兼容性而保留。请改用*此其他方法*。
- 此方法最初是DOM Level 2 Traversal and Range的一部分,但在当前的 DOM 规范中已不存在。此功能已不再有望成为标准。
- 此事件处理程序是旧版WebVR API的一部分,已被WebXR Device API取代。它已不再有望成为标准。