如何记录 CSS 属性
随着 CSS 标准的演变,新的属性不断被添加。MDN Web Docs 上的 CSS 参考 需要与这些发展保持同步。本文提供了创建 CSS 属性参考页面的分步说明。
每个 CSS 属性参考页面都遵循相同的结构。这有助于读者更容易地查找信息,尤其是在他们熟悉标准参考页面格式之后。
步骤 1 - 确定要记录的属性
首先,你需要找到要记录的 CSS 属性。你可能注意到某个页面缺失,或者你可能在我们的 问题列表 中看到了关于缺失内容的报告。有关 CSS 属性的详细信息,你需要找到相关的规范(例如,W3C 规范,或用于 Gecko 或 Blink 等渲染引擎的非标准属性的错误报告)。
注意:使用 W3C 规范时,始终使用编辑草案(注意左侧的红色横幅),而不是已发布的版本(例如,工作草案)。编辑草案始终更接近最终版本!
如果实现和规范有偏差,请随时在实现错误中提及。以下情况之一可能是真的
- 这可能是实现中的错误(将提交后续错误)。
- 这可能是由于新规范发布延迟所致。
- 这可能是规范中的错误(在这种情况下,值得提交规范错误)。
步骤 2 - 检查 CSS 属性数据库
CSS 属性的几个特性,例如其语法或是否可以进行动画,会在几个页面中提到,因此存储在一个特定数据库中。你在页面上使用的宏需要有关存储在该数据库中的属性的信息,因此首先 检查这些信息是否存在。
步骤 3 - 创建 CSS 属性页面
步骤 4 - 获取内容审核
创建属性页面后,将其作为拉取请求提交。我们的审查团队成员将自动被分配来审查你的页面。