如何记录 CSS 属性

随着 CSS 标准的演变,新的属性不断被添加。MDN Web Docs 上的 CSS 参考 需要与这些发展保持同步。本文提供了创建 CSS 属性参考页面的分步说明。

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

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

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

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

如果实现和规范有偏差,请随时在实现错误中提及。以下情况之一可能是真的

  • 这可能是实现中的错误(将提交后续错误)。
  • 这可能是由于新规范发布延迟所致。
  • 这可能是规范中的错误(在这种情况下,值得提交规范错误)。

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

CSS 属性的几个特性,例如其语法或是否可以进行动画,会在几个页面中提到,因此存储在一个特定数据库中。你在页面上使用的宏需要有关存储在该数据库中的属性的信息,因此首先 检查这些信息是否存在

步骤 3 - 创建 CSS 属性页面

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

创建参考页面时,你将需要添加示例。为此,请遵循此 关于实时示例的教程。请记住,你正在创建的属性页面用于单个属性,因此你添加的示例需要展示此属性如何独立工作,而不是展示如何将整个规范与其他属性、伪类或伪元素组合在一起以生成良好的效果。可以编写教程和指南来展示更多内容。

步骤 4 - 获取内容审核

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