dom

此儲存庫託管 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 > &hellip;) </ code > </ dfn >
method, when invoked, must run these steps:

沒問題並且

 < p > The < dfn method for = DOMTokenList
lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > &hellip;) </ 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 > .