页面类型

要在 MDN 上创建新页面，你需要使用 GitHub——请查看我们的 content 仓库的 README 以获取更多说明。

在创建新页面时，你可以参考我们的页面模板（参阅下面的各小节），以确保你使用了正确的页面结构/内容。你可以通过点击每个模板底部的“Source on GitHub”来查看每个模板的源代码（如果你想复制它）。这些页面模板作为发布页面没有多大意义，但是如果你查看它们的源代码，你会发现它们包含了很多有用的注释、占位符和提示，详细说明了如何填写缺失的信息并创建你的页面。

在每个模板的顶部，你会发现一个名为请在发布前删除（Remove before publishing）的部分，它包含了如何填写页面标题、别名（slug）、侧边栏菜单和标签（例如，不会出现在文章正文中的信息）的信息。在按照其中的说明进行操作后，你需要删除此部分，然后才能认为页面已经完成。

有时，你会发现风格老旧的参考页，它们与这里介绍的模板有明显的不同。例如，旧式的接口页面将所有接口成员的详细信息都放在一个页面上，而单独的方法/属性/构造函数/事件监听器页面并不存在。

如果你发现了一个旧式页面，我们希望你能将其更新为新式页面！但是，我们知道这可能是一项巨大的工作。如果需要更新的信息不是太多，并且你有一些空闲时间，那么请尝试将其更新为新式页面。

如果工作量很大，那么在确定工作优先级时，你应该考虑以下几个因素：

• 信息有多过时？
• 信息的质量有多差？
• 该特性有多受欢迎？信息有多受欢迎？

如果你想组建一个团队来完成更新，或者只是想报告或讨论一些需要更新的内容，请随时提交内容议题，或向我们寻求帮助。

我们定义了 page-type 元数据键，以清晰地标识 MDN 页面的类型。下面链接的模板指出了每个页面类型应该设置哪个 page-type 值。

完整的页面类型列表请参阅 page-type 元数据键 (en-US)。

API 着陆页提供了一个概述，说明特定 API 的作用，以及该 API 提供的每个接口、全局变量、函数等的文档链接。除非链接出现在概述文本的上下文中，否则页面不会直接链接到 API 类中的特定方法或属性。它主要是一个导航页面，但也作为 API 的概览参考页面。

在某些情况下，可能会有多个不同的 API，它们在各自的规范中定义，但它们密切相关，因此使用单个 API 着陆页来涵盖它们是有意义的。例如，通用传感器 API 涵盖了通用传感器的内容，但其他 API 则涵盖了更具体的内容，例如环境光传感器、运动传感器，等等。在此类情况下，许多高级的概念是相同的，因此在多个着陆页重复这些概念并无意义。所以，将它们全部涵盖在一个“Web 传感器”着陆页，可避免重复，简化查询。

• WebVR API

• API 着陆页模板 (en-US)

API 着陆页列出了属于特定接口或类的所有方法、属性、事件等。它提供了该类或接口的概述，以及每个成员的文档链接。它比 API 着陆页的粒度更细，后者通常链接到多个 API 参考页。

• Fetch API 的 Request 接口。

• API 参考页模板 (en-US)

API 参考子页面是 API 参考页的子页面。它详细记录了单个接口成员。

• IDBIndex 接口的 count() 方法 (en-US)（属于 IndexedDB API）
• VRDisplay 接口的 capabilities 属性 (en-US)（属于 WebVR API）
• Request 接口的 Request() 构造函数（属于 Fetch API）
• vrdisplaypresentchange 事件 (en-US)（属于 WebVR API，挂载在 Window 接口下）接口

• API 方法子页面模板 (en-US)
• API 属性子页面模板 (en-US)
• API 构造函数子页面模板 (en-US)
• API 事件子页面模板 (en-US)

HTML 参考页列出了特定 HTML 元素所有可用的属性，解释了元素的目的和用法，并提供了示例、浏览器兼容性信息及其他重要数据。

• <video> 元素

• HTML 元素页面模板 (en-US)

SVG 参考页列出了特定 SVG 元素所有可用的属性，解释了元素的目的和用法，并提供了示例、浏览器兼容性信息及其他重要数据。

• <g> 元素

• SVG 元素页面模板 (en-US)

每个 CSS 模块都代表一种 CSS 规范，为 CSS 中的某些功能和实现提供支持。例如，CSS 基础框盒模型模块代表了描述 margin 和 padding 属性的规范，通过这些属性，你可以在 CSS 盒内和周围创建间距。

CSS 模块着陆页概述了模块提供的功能，并列出了模块提供的所有属性、数据类型、CSS 函数等。在可能的情况下，CSS 模块着陆页还会通过互动示例快速演示使用模块中的属性可以实现哪些功能。模块着陆页主要用作导航页面，但同时也是模块的概览参考页面。

一些相关属性和特性属于其他模块，但若与你正在记录的模块所提供的功能密切相关，也可以在相关概念部分介绍。例如，<easing-function> 数据类型和 prefers-reduced-motion 媒体查询并不包含在 CSS 动画模块中，但由于它们与 CSS 动画密切相关，因此在 CSS 动画模块着陆页的相关概念部分提及它们是个好主意。

• CSS 动画
• CSS 基本用户接口
• CSS 滤镜效果 (en-US)
• CSS 滚动界限

• CSS 模块着陆页模板 (en-US)

CSS 参考页列出了某一 CSS 特性（如选择器或属性）的所有可用语法，解释了特性的目的和用法，并提供了示例、浏览器兼容性信息及其他重要数据。

• background-color 属性
• :hover 伪类
• @media @ 规则

• CSS 属性页面模板 (en-US)
• CSS 选择器页面模板 (en-US)

HTTP 标头参考页列出了 HTTP 标头可包含的所有可用指令，并解释了标头的目的和用法。它还提供了示例、浏览器兼容性信息及其他重要数据。

• Cache-Control 标头

• HTTP 标头页面模板 (en-US)

概念页是一个指南页，用于解释或教授某些内容。通常，如果一个页面主要包含散文（prose），并且不属于其他页面类型，那么它可能是一个概念页。对一个主题的深入讨论可能会分布在多个概念页上，并使用 Next 和 Previous 宏进行链接。

• 使用 WebVR API
• 基于 Web Audio API 的可视化
• CSS 的层叠与继承

术语页包含了对术语、主题或概念的简要解释。第一段应该是一个简单、独立的术语描述，不超过几句话。可以在之后的参见部分列出指向更多信息的链接。如果页面超过了一屏的高度，那它就太长了，应该将其转换为概念页。有关更多详细信息，请参阅如何撰写和引用一个术语表中的条目。

• DOM
• 异常
• 超链接

• 术语页模板 (en-US)

着陆页作为其子页面的菜单，因此主要作为导航页面。着陆页布局通常用于关于特定主题的页面树的根页面。它以对主题的简要概述开头，然后呈现一个结构化的链接列表，指向其子页面，以及可选的其他对读者有用的材料。

子页面列表可使用 SubpagesWithSummaries 和 LandingPageListSubpages 模板自动生成。但是，在更复杂的情况下，列表可能需要手动创建（和维护！）。

• HTML
• CSS
• Web API
• JavaScript
• 学习区
• 为 MDN 做贡献