橫幅和通知
橫幅和通知會顯示在某些頁面上,尤其是在 API 參考頁面上,目的是突出顯示會影響內容使用方式的重要因素。例如,橫幅用於指出某個介面、方法或屬性何時已被棄用,不應在生產程式碼中使用,或者只能在安全上下文中進行使用。
橫幅是使用頁面內容中的宏渲染的。有些橫幅宏會自動新增到頁面中,而另一些則是手動新增的。
本文介紹了更重要的橫幅以及它們的新增方式。
橫幅宏在哪裡新增
橫幅是使用宏新增的,通常插在頁面元資料下方,與頁面側邊欄宏並列。例如,在下面的塊中,{{SecureContext_Header}} 宏用於指示 AudioDecoder 介面僅在 安全上下文 中可用,{{AvailableInWorkers}} 宏用於指示 AudioDecoder 介面僅在 視窗上下文 和 專用工作執行緒上下文 中可用,而 {{SeeCompatTable}} 的新增則用於指示該介面是實驗性的。
---
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")}}
必須手動新增的橫幅
您需要手動新增以下宏
自動新增的橫幅
為了匹配 browser compat data 儲存庫中的狀態,以下宏會自動新增到內容中。
{{SeeCompatTable}}— 生成一個“這是一項實驗性技術”的橫幅,指示該技術是 實驗性 的。{{Deprecated_Header}}— 生成一個“已棄用”的橫幅,指示使用該技術是 不推薦 的。{{Non-standard_Header}}— 生成一個“非標準”的橫幅,指示該技術的使用不屬於正式規範,即使它在多個瀏覽器中都有實現。
更新 browser-compat-data 儲存庫中的功能狀態 以更改這些值。
注意:雖然您可以手動新增/更新內容中的這些宏,但與瀏覽器相容性資料不匹配的值將被替換/刪除。
注意:帶有 {{SeeCompatTable}}、{{Deprecated_Header}} 或 {{Non-standard_Header}} 橫幅的頁面,其頁面元資料中也會包含相應的 experimental、deprecated 和 non-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>替換為反對該功能的瀏覽器供應商數量。 - 根據情況使用
vendor或vendors。
- 將
-
在上述橫幅的同一頁面上新增一個“標準立場”部分,作為“規範”標準部分的子部分。
注意:請參閱 相關網站集,瞭解“標準立場”部分的示例及其應包含的內容,以及著陸頁橫幅。