規範表格

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

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