dom

พื้นที่เก็บข้อมูลนี้โฮสต์มาตรฐาน DOM

จรรยาบรรณ

เรามุ่งมั่นที่จะมอบสภาพแวดล้อมที่เป็นมิตร ปลอดภัย และเป็นมิตรสำหรับทุกคน โปรดอ่านและเคารพหลักจรรยาบรรณ

โอกาสในการมีส่วนร่วม

ผู้คนสังเกตเห็นปัญหาเล็กๆ น้อยๆ และปัญหาใหญ่ๆ เกี่ยวกับมาตรฐาน DOM ตลอดเวลา และเรายินดีเป็นอย่างยิ่งที่คุณจะช่วยแก้ไขปัญหาเหล่านั้น เรายินดีรับคำขอดึงข้อผิดพลาดด้านการพิมพ์และไวยากรณ์ด้วยเช่นกัน

ปัญหาที่มีป้ายกำกับว่า "ปัญหาแรกที่ดี" เป็นจุดที่ดีในการลองแก้ไขมาตรฐาน DOM โปรดทราบว่าเราไม่ได้มอบหมายปัญหาและไม่มีเหตุผลที่จะขอความพร้อมเช่นกัน เพียงแค่ส่งคำขอดึงข้อมูล

หากคุณกำลังคิดที่จะแนะนำคุณสมบัติใหม่ โปรดอ่านเอกสารคำถามที่พบบ่อยและโหมดการทำงานเพื่อทำความคุ้นเคยกับกระบวนการนี้

เรายินดีที่จะช่วยเหลือคุณในเรื่องทั้งหมดนี้ทาง Chat

ดึงคำขอ

กล่าวโดยย่อคือ เปลี่ยน dom.bs และส่งแพตช์ของคุณด้วยข้อความยืนยันที่ดี

โปรดเพิ่มชื่อของคุณในส่วนการรับทราบในคำขอดึงครั้งแรกของคุณ แม้จะเป็นเพียงการแก้ไขเล็กน้อยก็ตาม ชื่อจะถูกจัดเรียงตามพจนานุกรม

เพื่อให้แน่ใจว่าแพตช์ของคุณตรงตามข้อกำหนดที่จำเป็นทั้งหมด โปรดดูหลักเกณฑ์สำหรับผู้สนับสนุนด้วย ผู้แก้ไขมาตรฐาน DOM ได้รับการคาดหวังให้ปฏิบัติตามแนวทางผู้ดูแล

การทดสอบ

การทดสอบเป็นส่วนสำคัญของกระบวนการมาตรฐาน และจะต้องสร้างหรือปรับเปลี่ยนเมื่อมีการเปลี่ยนแปลงมาตรฐาน การทดสอบสำหรับมาตรฐาน DOM สามารถพบได้ในไดเร็กทอรี dom/ ของ web-platform-tests/wpt

สามารถดูแดชบอร์ดที่แสดงการทดสอบการทำงานกับเอ็นจิ้นของเบราว์เซอร์ได้ที่ 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>

หากองค์ประกอบ "block" มีองค์ประกอบ "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.

เป็น.

แท็กปิดท้ายอาจรวมอยู่ด้วย (หากทำอย่างสม่ำเสมอ) และแอตทริบิวต์อาจอยู่ในเครื่องหมายคำพูด (โดยใช้เครื่องหมายคำพูดคู่) แม้ว่าธีมที่แพร่หลายคือการละเว้นแท็กปิดท้ายและไม่ใช่เครื่องหมายคำพูดแอตทริบิวต์ (เว้นแต่ว่าจะมีการเว้นวรรค)

วางหนึ่งบรรทัดใหม่ระหว่างย่อหน้า (รวมถึงองค์ประกอบรายการ) วางสามบรรทัดใหม่ก่อนหน้า <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 >

ใช้ Camel-case สำหรับชื่อตัวแปร และใช้ชื่อ "เว้นวรรค" สำหรับคำจำกัดความ อัลกอริธึม ฯลฯ

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