dom

Dieses Repository hostet den DOM-Standard.

Verhaltenskodex

Wir sind bestrebt, allen eine freundliche, sichere und einladende Umgebung zu bieten. Bitte lesen und respektieren Sie den Verhaltenskodex.

Beitragsmöglichkeiten

Die Leute bemerken ständig kleinere und größere Probleme mit dem DOM-Standard und wir würden uns über Ihre Hilfe bei der Behebung dieser Probleme freuen. Auch Pull-Requests für Tipp- und Grammatikfehler sind herzlich willkommen.

Ausgaben mit der Bezeichnung „gute erste Ausgabe“ sind ein guter Ort, um einen Eindruck von der Bearbeitung des DOM-Standards zu bekommen. Beachten Sie, dass wir keine Probleme zuweisen und es auch keinen Grund gibt, nach der Verfügbarkeit zu fragen. Stellen Sie einfach eine Pull-Anfrage.

Wenn Sie darüber nachdenken, eine neue Funktion vorzuschlagen, lesen Sie die FAQ- und Arbeitsmodus-Dokumente durch, um sich mit dem Prozess vertraut zu machen.

Gerne helfen wir Ihnen bei all dem im Chat weiter.

Pull-Anfragen

Kurz gesagt: Ändern Sie dom.bs und senden Sie Ihren Patch mit einer guten Commit-Nachricht.

Bitte fügen Sie Ihren Namen im Abschnitt „Danksagungen“ in Ihrem ersten Pull-Request hinzu, auch bei trivialen Korrekturen. Die Namen sind lexikografisch sortiert.

Um sicherzustellen, dass Ihr Patch alle erforderlichen Anforderungen erfüllt, lesen Sie bitte auch die Richtlinien für Mitwirkende. Von den Herausgebern des DOM-Standards wird erwartet, dass sie die Maintainer-Richtlinien befolgen.

Tests

Tests sind ein wesentlicher Bestandteil des Standardisierungsprozesses und müssen erstellt oder angepasst werden, wenn Änderungen am Standard vorgenommen werden. Tests für den DOM-Standard finden Sie im Verzeichnis dom/ von web-platform-tests/wpt .

Ein Dashboard, das die Tests zeigt, die für Browser-Engines ausgeführt werden, finden Sie unter wpt.fyi/results/dom.

Bauen „lokal“

Für eine schnelle lokale Iteration führen Sie make ; Dabei wird ein Webdienst zum Erstellen des Standards verwendet, sodass Sie nichts installieren müssen. Weitere Informationen finden Sie in den Richtlinien für Mitwirkende.

Formatierung

Verwenden Sie eine Spaltenbreite von 100 Zeichen.

Verwenden Sie keine Zeilenumbrüche innerhalb von „Inline“-Elementen, auch wenn dies bedeutet, dass die erforderliche Spaltenbreite überschritten wird.

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

ist okay und

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

ist nicht.

Die Verwendung von Zeilenumbrüchen zwischen „Inline“-Element-Tag-Namen und deren Inhalt ist ebenfalls verboten. (Dies ändert tatsächlich den Inhalt, indem Leerzeichen hinzugefügt werden.) Das ist

 < a > token </ a >

ist in Ordnung und

 < a > token
</ a >

ist nicht.

Ein <li> -Element enthält immer ein <p> -Element, es sei denn, es ist ein untergeordnetes Element von <ul class=brief> .

Wenn ein „Block“-Element ein einzelnes „Block“-Element enthält, platzieren Sie es nicht in einer neuen Zeile.

Nichts außer einem neuen „Block“-Element einrücken. Zum Beispiel

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

ist nicht eingerückt, aber

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

Ist.

End-Tags können eingefügt werden (sofern dies konsistent erfolgt) und Attribute können in Anführungszeichen gesetzt werden (unter Verwendung von doppelten Anführungszeichen). Das vorherrschende Thema besteht jedoch darin, End-Tags wegzulassen und Attribute nicht in Anführungszeichen zu setzen (es sei denn, sie enthalten ein Leerzeichen).

Platzieren Sie eine neue Zeile zwischen Absätzen (einschließlich Listenelementen). Platzieren Sie drei Zeilenumbrüche vor <h2> und zwei Zeilenumbrüche vor anderen Überschriften. Dies gilt nicht, wenn eine verschachtelte Überschrift auf die übergeordnete Überschrift folgt.

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

Verwenden Sie die Groß-/Kleinschreibung für Variablennamen und „Leerzeichen“-Namen für Definitionen, Algorithmen usw.

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