dom

Repositori ini menampung Standar DOM.

Kode etik

Kami berkomitmen untuk menyediakan lingkungan yang ramah, aman, dan ramah bagi semua. Harap membaca dan menghormati Kode Etik.

Peluang kontribusi

Orang-orang selalu memperhatikan masalah kecil dan besar dengan Standar DOM dan kami ingin bantuan Anda memperbaikinya. Permintaan tarik untuk kesalahan ketik dan tata bahasa juga dipersilakan.

Terbitan berlabel "terbitan pertama yang bagus" adalah tempat yang baik untuk mencoba mengedit Standar DOM. Perhatikan bahwa kami tidak menetapkan masalah dan tidak ada alasan untuk menanyakan ketersediaan, cukup berikan permintaan penarikan.

Jika Anda berpikir untuk menyarankan fitur baru, bacalah FAQ dan dokumen Mode Kerja agar Anda memahami prosesnya.

Kami akan dengan senang hati membantu Anda dengan semua ini di Obrolan.

Tarik permintaan

Singkatnya, ubah dom.bs dan kirimkan patch Anda, dengan pesan komit yang bagus.

Harap tambahkan nama Anda ke bagian Ucapan Terima Kasih di permintaan penarikan pertama Anda, bahkan untuk perbaikan sepele. Nama-nama tersebut diurutkan secara leksikografis.

Untuk memastikan patch Anda memenuhi semua persyaratan yang diperlukan, harap lihat juga Pedoman Kontributor. Editor Standar DOM diharapkan mengikuti Pedoman Pengelola.

Tes

Pengujian merupakan bagian penting dari proses standardisasi dan perlu dibuat atau disesuaikan seiring dengan dilakukannya perubahan terhadap standar. Pengujian untuk Standar DOM dapat ditemukan di direktori dom/ di web-platform-tests/wpt .

Dasbor yang menunjukkan pengujian yang dijalankan terhadap mesin browser dapat dilihat di wpt.fyi/results/dom.

Membangun "secara lokal"

Untuk iterasi lokal yang cepat, jalankan make ; ini akan menggunakan layanan web untuk membangun standar, sehingga Anda tidak perlu menginstal apa pun. Lihat selengkapnya di Pedoman Kontributor.

Pemformatan

Gunakan lebar kolom 100 karakter.

Jangan gunakan baris baru di dalam elemen "sebaris", meskipun itu berarti melebihi persyaratan lebar kolom.

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

tidak apa-apa dan

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

tidak.

Penggunaan baris baru antara nama tag elemen "sebaris" dan kontennya juga dilarang. (Ini sebenarnya mengubah konten, dengan menambahkan spasi.) Yaitu

 < a > token </ a >

baik-baik saja dan

 < a > token
</ a >

tidak.

Elemen <li> selalu memiliki elemen <p> di dalamnya, kecuali elemen tersebut merupakan turunan dari <ul class=brief> .

Jika elemen "blok" berisi satu elemen "blok", jangan letakkan di baris baru.

Jangan membuat indentasi apa pun kecuali elemen "blok" baru. Misalnya

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

tidak menjorok ke dalam, tapi

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

adalah.

Tag akhir dapat dimasukkan (jika dilakukan secara konsisten) dan atribut dapat dikutip (menggunakan tanda kutip ganda), meskipun tema umum adalah menghilangkan tag akhir dan tidak mengutip atribut (kecuali jika mengandung spasi).

Tempatkan satu baris baru di antara paragraf (termasuk elemen daftar). Tempatkan tiga baris baru sebelum <h2> , dan dua baris baru sebelum judul lainnya. Hal ini tidak berlaku bila judul bertumpuk mengikuti judul induk.

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

Gunakan huruf unta untuk nama variabel dan nama "spasi" untuk definisi, algoritme, dll.

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