该存储库托管 DOM 标准。
我们致力于为所有人提供一个友好、安全和热情的环境。请阅读并尊重行为准则。
人们总是注意到 DOM 标准的大小问题,我们希望您能帮助解决这些问题。针对印刷和语法错误的拉取请求也非常受欢迎。
标记为“goodfirst issues”的问题是体验编辑 DOM 标准的好地方。请注意,我们不会分配问题,也没有理由询问可用性,只需提供拉取请求。
如果您正在考虑建议新功能,请通读常见问题解答和工作模式文档以熟悉该流程。
我们很乐意在 Chat 上帮助您解决所有这些问题。
简而言之,更改dom.bs
并提交您的补丁,并附上良好的提交消息。
请将您的名字添加到您的第一个拉取请求中的致谢部分,即使是简单的修复。名称按字典顺序排序。
为了确保您的补丁满足所有必要的要求,另请参阅贡献者指南。 DOM 标准的编辑者应该遵循维护者指南。
测试是标准化过程的重要组成部分,需要随着标准的变化而创建或调整。 DOM 标准的测试可以在web-platform-tests/wpt
的dom/
目录中找到。
显示针对浏览器引擎运行的测试的仪表板可以在 wpt.fyi/results/dom 中看到。
要快速进行本地迭代,请运行make
;这将使用网络服务来构建标准,这样您就不必安装任何东西。请参阅贡献者指南中的更多内容。
使用 100 个字符的列宽。
不要在“内联”元素内使用换行符,即使这意味着超出列宽要求。
< p > The
< dfn method for = DOMTokenList lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > …) </ code > </ dfn >
method, when invoked, must run these steps:
没问题并且
< p > The < dfn method for = DOMTokenList
lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > …) </ code > </ dfn > method, when
invoked, must run these steps:
不是。
也禁止在“内联”元素标记名称及其内容之间使用换行符。 (这实际上通过添加空格来改变内容。)
< a > token </ a >
很好并且
< a > token
</ a >
不是。
<li>
元素内部始终包含一个<p>
元素,除非它是<ul class=brief>
的子元素。
如果“块”元素包含单个“块”元素,请勿将其放在换行符上。
除了新的“块”元素之外,不要缩进任何内容。例如
< li > < p > For each < var > token </ var > in < var > tokens </ var > , in given order, that is not in
< a > tokens </ a > , append < var > token </ var > to < a > tokens </ a > .
不是缩进的,但是
< ol >
< li >
< p > For each < var > token </ var > in < var > tokens </ var > , run these substeps:
< ol >
< li > < p > If < var > token </ var > is the empty string, < a > throw </ a > a {{SyntaxError}} exception.
是。
可以包含结束标签(如果一致)并且可以引用属性(使用双引号),尽管普遍的主题是省略结束标签而不引用属性(除非它们包含空格)。
在段落之间放置一个换行符(包括列表元素)。在<h2>
之前放置三个换行符,在其他标题之前放置两个换行符。当嵌套标题位于父标题之后时,这不适用。
< ul >
< li > < p > Do not place a newline above.
< li > < p > Place a newline above.
</ ul >
< p > Place a newline above.
< h3 > Place two newlines above. </ h3 >
< h4 > Placing one newline is OK here. </ h4 >
< h4 > Place two newlines above. </ h4 >
对变量名称使用驼峰式大小写,对定义、算法等使用“空格”名称。
< p > A < a for = / > request </ a > has an associated
< dfn export for = request id = concept-request-redirect-mode > redirect mode </ dfn > ,...
< p > Let < var > redirectMode </ var > be < var > request </ var > 's < a for = request > redirect mode </ a > .