Spesifikasi kod JavaScript

Jfail javaScript

Atur cara JavaScript hendaklah disimpan secara berasingan dalam fail dengan akhiran .js.

Kod JavaScript tidak boleh disertakan dalam fail HTML melainkan ia adalah sekeping kod khusus yang hanya dimiliki oleh bahagian ini. Kod JavaScript dalam HTML akan meningkatkan saiz fail dengan ketara, dan ia tidak boleh dicache atau dimampatkan.

Lekukan

Unit lekukan ialah empat ruang. Elakkan menggunakan kekunci Tab untuk mengesot (walaupun kini dalam abad ke-21), masih tiada standard bersatu untuk panjang Tab. Walaupun menggunakan ruang meningkatkan saiz fail, ia hampir boleh diabaikan pada rangkaian kawasan setempat dan boleh dihapuskan semasa proses pengecilan.

Panjang setiap baris

Elakkan melebihi 80 aksara setiap baris. Apabila pernyataan tidak sesuai pada satu baris, pertimbangkan untuk membungkusnya. Dalam simbol operasi, lebih baik meletakkan baris baharu selepas koma. Membungkus baris selepas pengendali mengurangkan kemungkinan ralat salin-tampal ditutup oleh koma bertitik. Baris seterusnya hendaklah diinden 8 ruang.

Ulasan

Jangan kedekut pada ulasan. Ia sangat berguna untuk meninggalkan maklumat untuk orang yang perlu memahami kod anda pada masa hadapan (mungkin diri anda sendiri). Komen hendaklah ditulis dengan baik dan jelas seperti kod yang mereka ulas. Sedikit jenaka kadang-kadang lebih baik. Ingatlah untuk mengelak daripada menjadi kata-kata atau emosi.

Ia juga penting untuk mengemas kini ulasan tepat pada masanya. Komen yang salah boleh menyebabkan program lebih sukar dibaca dan difahami.

Pengisytiharan Pembolehubah

Semua pembolehubah mesti diisytiharkan sebelum digunakan. JavaScript tidak memerlukan ini, tetapi ia menjadikan program lebih mudah dibaca dan memudahkan untuk mencari pembolehubah yang tidak diisytiharkan (ia akan disusun menjadi pembolehubah global).

Letakkan pernyataan var pada permulaan fungsi.

Sebaik-baiknya letakkan pernyataan pengisytiharan setiap pembolehubah pada baris yang berasingan dan tambah ulasan. Semua pembolehubah disusun mengikut abjad.

var currentEntry; // Pilihan semasa

peringkat var; // Tahap lekukan

saiz var; // Saiz jadual

Pengisytiharan fungsi

Semua fungsi mesti diisytiharkan sebelum digunakan. Pengisytiharan fungsi dalam mengikuti pernyataan var. Ini boleh membantu menentukan pembolehubah yang berada dalam skop fungsi.

Sepatutnya tiada ruang antara nama fungsi dan ((kurungan kiri).) (kurungan kanan) dan {(kurung kerinting kiri) yang memulakan badan program. Ruang harus dimasukkan. Badan program fungsi hendaklah diendenkan empat ruang. } (pendakap kanan) diselaraskan dengan kepala baris kod yang mengisytiharkan fungsi.

fungsi luar(c, d) {                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               

}

Penamaan

Nama pembolehubah hendaklah terdiri daripada 26 Ia terdiri daripada huruf besar dan huruf kecil (A..Z,a..z), 10 nombor (0..9), dan _ (garis bawah). Elakkan menggunakan aksara antarabangsa (seperti bahasa Cina) kerana ia tidak mudah dibaca dan difahami di mana-mana. Jangan gunakan $ (tanda dolar) atau (slash belakang) dalam nama.

Jangan gunakan _ (garis bawah) sebagai aksara pertama nama pembolehubah. Ia kadangkala digunakan untuk mewakili pembolehubah persendirian, tetapi sebenarnya JavaScript tidak menyediakan fungsi pembolehubah persendirian. Jika pembolehubah persendirian penting, gunakan borang ahli persendirian. Konvensyen penamaan yang mengelirukan ini harus dielakkan.

Kebanyakan nama pembolehubah dan nama kaedah hendaklah bermula dengan huruf kecil.

Nama pembina yang mesti digunakan dengan yang baharu hendaklah bermula dengan huruf besar. JavaScript tidak akan membuang sebarang ralat penyusunan atau ralat masa jalan apabila yang baharu ditinggalkan. Jika anda terlupa menambah baharu, perkara buruk akan berlaku (seperti dianggap sebagai fungsi biasa), jadi menggunakan huruf besar nama pembina adalah satu-satunya cara kita boleh mengelakkan perkara ini berlaku.

Pembolehubah global hendaklah dalam semua huruf besar. (JavaScript tidak mempunyai makro atau pemalar, jadi tidak akan berlaku salah faham)

Pernyataan

Pernyataan ringkas

Setiap baris mengandungi paling banyak satu pernyataan. Letakkan ; (titik bertitik) pada akhir setiap pernyataan mudah. Ambil perhatian bahawa tugasan fungsi atau pernyataan tugasan objek juga merupakan pernyataan tugasan dan harus diakhiri dengan koma bertitik.

JavaScript boleh menganggap sebarang ungkapan sebagai pernyataan. Ini boleh menyembunyikan beberapa ralat dengan mudah, terutamanya ralat yang disebabkan oleh penambahan koma bertitik secara tidak sengaja. Ungkapan harus dianggap sebagai pernyataan berasingan hanya apabila ditugaskan dan dipanggil.

Pernyataan Kompleks

Pernyataan majmuk ialah urutan pernyataan yang disertakan dalam { } (tanda kurung).

Pernyataan yang dilampirkan mesti diindenkan empat ruang lagi. { (pendakap kiri) hendaklah berada di penghujung pelaksanaan pernyataan kompaun. } (pendkap kanan) hendaklah diselaraskan dengan permulaan baris { (pendkap kiri) Pendakap hendaklah digunakan dalam semua pernyataan gabungan, walaupun hanya terdapat satu pernyataan, apabila ia adalah sebahagian daripada struktur kawalan, seperti jika atau untuk kenyataan. Melakukan ini akan mengelakkan ralat semasa menambah pernyataan kemudian.

Penandaan

Penandaan pernyataan adalah pilihan, hanya pernyataan berikut mesti ditanda: sementara, lakukan, untuk, suis.

penyata pulangan

Jangan gunakan ( ) (tanda kurung) untuk menyertakan nilai pulangan dalam penyata pulangan dengan nilai pulangan. Jika ungkapan dikembalikan, ungkapan itu hendaklah berada pada baris yang sama dengan kata kunci pulangan untuk mengelakkan ralat koma bertitik tidak disengajakan.

teruskan kenyataan

Elakkan menggunakan kenyataan teruskan. Ia dengan mudah boleh membuat logik program menjadi kabur.

dengan pernyataan

Jangan gunakan pernyataan dengan.

Kosong

Menggunakan baris kosong untuk memisahkan blok kod yang berkaitan secara logik boleh meningkatkan kebolehbacaan atur cara.

Ruang hendaklah digunakan dalam situasi berikut:

• Kata kunci berikut ((kurungan kiri) hendaklah dipisahkan dengan ruang. manakala (benar) {
• Parameter fungsi Perlu ada tiada ruang antara ((kurung kurung kiri) dan ((kurung kurung kiri)). Ini membantu membezakan kata kunci daripada panggilan fungsi.

• Semua pengendali binari kecuali .(titik) dan ((kurungan kiri) dan [ (persegi kiri kurungan) hendaklah dipisahkan daripada operan dengan ruang

• Tiada ruang antara operator unari dan operannya, melainkan operator ialah perkataan, seperti

• Setiap satu ; (titik koma) dalam bahagian kawalan, seperti untuk pernyataan, mesti diikuti dengan ruang

• Setiap , (koma) hendaklah diikuti dengan ruang

Peraturan untuk objek definisi:

Letakkan kurungan kerinting pembuka dan nama kelas pada baris yang sama

Terdapat ruang antara titik bertindih dan nilai atribut Gunakan petikan berganda untuk rentetan, bukan untuk nombor.

Jangan tambah koma selepas pasangan atribut-nilai terakhir Letakkan kurungan kerinting kanan pada baris berasingan dan akhirinya dengan simbol

Sambungan fail

.

Akhiran fail HTML boleh menjadi .html (atau r .htm).

Akhiran fail CSS ialah .css.

Akhiran fail JavaScript ialah .js .

Gunakan nama fail huruf kecil

Kebanyakan pelayan web (Apache, Unix) adalah sensitif huruf besar/kecil: london.jpg tidak boleh diakses melalui London. jpg .

Pelayan web lain (Microsoft, IIS) tidak sensitif huruf besar-besaran: london.jpg boleh diakses sebagai London.jpg atau london.jpg.

Anda mesti mengekalkan gaya yang konsisten dan kami mengesyorkan menggunakan nama fail huruf kecil secara konsisten.