如何记录 CSS 属性

新的属性随着 CSS 标准的发展而不断添加。MDN Web 文档上的 CSS 参考需要紧跟其发展。本文提供了创建 CSS 属性参考页面的步骤说明。

每个 CSS 属性参考页面都遵循相同的结构。这有助于读者更容易地找到信息,特别是在他们熟悉标准参考页面的格式之后。

步骤 1——确定要记录的属性

首先,你需要找出要记录的 CSS 属性。你可能已经注意到某个页面的缺失,或者你在我们的议题列表中看到了缺失的内容。要了解 CSS 属性的详细信息,你需要找到相关的规范(例如,W3C 规范,或者用于渲染引擎(如 Gecko 或 Blink)的非标准属性的错误报告)。

备注: 使用 W3C 规范时,请始终使用编辑草案(Editor's Draft,请注意左侧的红色横幅),而不是已发布的版本(例如,工作草案)。编辑草案总是更接近最终版本!

如果实现和规范不一致,请在实现错误中提及。可能有以下几种情况:

  • 这可能是实现的一个错误(并在内容中提及相关错误)。
  • 这可能是因为新规范的延迟发布。
  • 这可能是规范的一个错误(在这种情况下,值得提及规范错误)。

步骤 2——检查 CSS 属性数据库

CSS 属性的特性(例如其语法以及是否可动)会在多个页面中提及,因此,它们会被存储在一个特定的数据库中。你将在页面中使用的宏需要这些存储的信息,所以,请检查这些信息是否存在

步骤 3——创建 CSS 属性页面

准备工作完成!现在,我们可以添加实际的 CSS 属性页面了。创建新的 CSS 属性页面的最简单的方法是复制现有的 CSS 属性页面的内容,并为将其编辑为新属性的内容。要创建新页面,请参阅我们的如何创建页面指南中的说明。

在创建参考页时,你需要添加示例。为此,请遵循有关运行实例的教程。请注意,你正在创建的属性页面是针对单个属性的,因此,你添加的示例需要显示该属性如何独立工作,而不是整个规范如何使用。因此,list-style-type 属性的示例应该显示使用该属性的不同值的结果,而不是如何将其与其他属性、伪类或伪元素组合以生成漂亮的效果。可以编写教程和指南来展示更多内容。

步骤 4——内容审查

在创建属性页面后,请将其以拉取请求的形式提交。会自动分配我们审查团队的成员来审查你的页面。