功能状态
功能状态向开发人员提供有关浏览器供应商之间功能实现阶段的信息,并且是以下状态之一:
如果上述状态均不适用,则该功能被视为稳定且标准的功能。我们不会在内容页面中显式添加此状态。有关这些术语的更多信息,请参阅"实验性、已弃用和已过时"页面。
要查看有关如何为功能选择状态的详细说明,请参阅@mdn/browser-compat-data
(BCD) 存储库中的选择状态属性部分。
如何添加或更新功能状态
MDN 上记录的所有功能的功能状态都在其附带的@mdn/browser-compat-data (BCD) 存储库条目中定义,并在发布新的BCD 版本时自动更新到mdn/content
存储库中。
警告:不要手动更新mdn/content
存储库中的功能状态。要更新功能的状态,您需要在 BCD 存储库中提交拉取请求。在您的更改在 BCD 中获得批准并合并后,自动拉取请求会更新mdn/content
存储库中的状态。
自动化使用前置 matter 中的browser-compat
键。该键存储查找兼容性数据中功能所需的 BCD 查询。如果browser-compat
键具有多个值,则自动化仅使用第一个值来呈现状态宏。
如何在内容中指定功能状态?
以下部分记录了在 MDN 文档中呈现功能状态的机制。如前所述,您应将这些机制视为只读,因为它们包含在内容中是自动化的。
侧边栏中的功能状态图标
要显示列在侧边栏中的功能的状态图标,使用前置 matterstatus
属性
---
title: Feature name
status:
- experimental
- non-standard
- deprecated
browser-compat: api.feature
---
渲染侧边栏时,代码会在每个页面的前置 matter 中查找状态。如前所述,这些状态会自动更新;您无需手动更改它们。
功能状态页面横幅
以下宏用于在页面标题中呈现状态横幅
{{SeeCompatTable}}
-
对于
experimental
状态。它生成一个**实验性状态**横幅 {{Non-standard_Header}}
-
对于
non-standard
状态。它生成一个**非标准状态**横幅**非标准:**此功能是非标准的,并且不在标准轨道上。请勿在面向 Web 的生产站点上使用它:它不会适用于每个用户。实现之间也可能存在很大的不兼容性,并且行为将来可能会发生变化。
{{Deprecated_Header}}
-
对于
deprecated
状态。它生成一个**已弃用状态**横幅**已弃用:**不再推荐使用此功能。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并在可能的情况下更新现有代码;请参阅此页面底部的兼容性表格以指导您的决策。请注意,此功能可能随时停止工作。
定义列表中的功能状态图标
以下宏用于在定义列表项旁边呈现内联状态图标
{{Experimental_Inline}}
图标: 实验性{{Non-standard_Inline}}
图标: 非标准{{Deprecated_Inline}}
图标: 已弃用