規範表格
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取代。它已不再有望成為標準。