橫幅和通知

橫幅和通知會顯示在某些頁面上,尤其是在 API 參考頁面上,目的是突出顯示會影響內容使用方式的重要因素。例如,橫幅用於指出某個介面、方法或屬性何時已被棄用,不應在生產程式碼中使用,或者只能在安全上下文中進行使用。

橫幅是使用頁面內容中的宏渲染的。有些橫幅宏會自動新增到頁面中,而另一些則是手動新增的。

本文介紹了更重要的橫幅以及它們的新增方式。

橫幅宏在哪裡新增

橫幅是使用宏新增的,通常插在頁面元資料下方,與頁面側邊欄宏並列。例如,在下面的塊中,{{SecureContext_Header}} 宏用於指示 AudioDecoder 介面僅在 安全上下文 中可用,{{AvailableInWorkers}} 宏用於指示 AudioDecoder 介面僅在 視窗上下文專用工作執行緒上下文 中可用,而 {{SeeCompatTable}} 的新增則用於指示該介面是實驗性的。

md
---
title: AudioDecoder
slug: Web/API/AudioDecoder
page-type: web-api-interface
status:
  - experimental
browser-compat: api.AudioDecoder
---

{{APIRef("WebCodecs API")}} {{SeeCompatTable}} {{SecureContext_Header}} {{AvailableInWorkers("window_and_dedicated")}}

必須手動新增的橫幅

您需要手動新增以下宏

  • {{SecureContext_Header}} — 此宏會生成一個“安全上下文”橫幅,指示該技術僅在 安全上下文 中可用。
  • {{AvailableInWorkers}} — 此宏會生成一個“在工作執行緒中可用”的通知,指示該技術可在 工作執行緒上下文 中使用。

自動新增的橫幅

為了匹配 browser compat data 儲存庫中的狀態,以下宏會自動新增到內容中。

  • {{SeeCompatTable}} — 生成一個“這是一項實驗性技術”的橫幅,指示該技術是 實驗性 的。
  • {{Deprecated_Header}} — 生成一個“已棄用”的橫幅,指示使用該技術是 不推薦 的。
  • {{Non-standard_Header}} — 生成一個“非標準”的橫幅,指示該技術的使用不屬於正式規範,即使它在多個瀏覽器中都有實現。

更新 browser-compat-data 儲存庫中的功能狀態 以更改這些值。

注意:雖然您可以手動新增/更新內容中的這些宏,但與瀏覽器相容性資料不匹配的值將被替換/刪除。

注意:帶有 {{SeeCompatTable}}{{Deprecated_Header}}{{Non-standard_Header}} 橫幅的頁面,其頁面元資料中也會包含相應的 experimentaldeprecatednon-standard 狀態值。元資料會在標題更新的同時自動更新。橫幅宏不依賴於此狀態元資料(但未來可能會從中生成)。

實驗性:“標準立場”橫幅

偶爾,瀏覽器供應商對一項功能的開發方式有不同意見,有些可能會反對其當前形式。在特殊情況下,MDN 會記錄處於此狀態的技術,以鼓勵 Web 社群進行實驗、提供反饋並幫助瀏覽器供應商達成共識。

重要的是要向讀者闡明這些功能當前的標準化狀態。雖然表示此資訊的長期解決方案尚未最終確定,但對於一些備受矚目的技術,我們正在採取以下措施以避免混淆:

  • 在此功能的著陸頁(而非每個子頁面)上新增此橫幅。

    md
    > [!WARNING]
    > This feature is currently opposed by <number> browser vendor(s). See the [Standards positions](#standards_positions) section below for details of opposition.
    
    • <number> 替換為反對該功能的瀏覽器供應商數量。
    • 根據情況使用 vendorvendors
  • 在上述橫幅的同一頁面上新增一個“標準立場”部分,作為“規範”標準部分的子部分。

注意:請參閱 相關網站集,瞭解“標準立場”部分的示例及其應包含的內容,以及著陸頁橫幅。