dom

このリポジトリは DOM 標準をホストします。

行動規範

私たちは、すべての人にとってフレンドリーで安全、歓迎的な環境を提供することに尽力しています。行動規範を読んで尊重してください。

貢献の機会

DOM 標準に関する軽微な問題から大きな問題まで、人々は常に気づいているので、それらを修正するためのご協力をお待ちしています。誤字や文法の間違いに関するプルリクエストも大歓迎です。

「良い最初の号」とラベル付けされた号は、DOM 標準の編集の味を知るのに適しています。私たちは問題を割り当てておらず、可用性を尋ねる理由もありません。プル リクエストを提供するだけであることに注意してください。

新しい機能を提案することを考えている場合は、FAQ と作業モードのドキュメントを読んでプロセスに慣れてください。

チャットでこれらすべてについて喜んでお手伝いさせていただきます。

プルリクエスト

つまり、 dom.bs変更し、適切なコミット メッセージを付けてパッチを送信します。

たとえ些細な修正であっても、最初のプル リクエストの謝辞セクションにあなたの名前を追加してください。名前は辞書順に並べ替えられます。

パッチが必要な要件をすべて満たしていることを確認するには、コントリビューター ガイドラインも参照してください。 DOM 標準の編集者は、メンテナ ガイドラインに従うことが期待されます。

テスト

テストは標準化プロセスの重要な部分であり、標準に変更が加えられると作成または調整する必要があります。 DOM 標準のテストはweb-platform-tests/wptのdom/ディレクトリにあります。

ブラウザ エンジンに対して実行されているテストを表示するダッシュボードは、wpt.fyi/results/dom で参照できます。

「ローカル」で構築する

ローカルで迅速に反復するには、 make実行します。これは Web サービスを使用して標準を構築するため、何もインストールする必要はありません。詳細については、寄稿者ガイドラインをご覧ください。

書式設定

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>要素は<ul class=brief>の子でない限り、その中に常に<p>要素を持ちます。

「block」要素に 1 つの「block」要素が含まれる場合、それを改行で置かないでください。

新しい「ブロック」要素以外はインデントしないでください。例えば

 < 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.

は。

終了タグを含めることができ (一貫して行われている場合)、属性を引用符で囲むことができます (二重引用符を使用)。ただし、一般的なテーマは、終了タグを省略し、属性を引用しないことです (スペースが含まれていない限り)。

段落間に 1 つの改行を入れます (リスト要素を含む)。 <h2>の前に 3 つの改行を配置し、他の見出しの前に 2 つの改行を配置します。これは、ネストされた見出しが親見出しの後に続く場合には適用されません。

 < 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 > .