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