Piawaian Kod JavaScript
Semua projek JavaScript menggunakan piawaian yang sama.
Spesifikasi kod JavaScript
Spesifikasi kod biasanya merangkumi aspek berikut:
Peraturan penamaan untuk pembolehubah dan fungsi
Ruang, lekukan, penggunaan peraturan ulasan.
Spesifikasi lain yang biasa digunakan...
Kod standard lebih mudah dibaca dan diselenggara.
Spesifikasi kod biasanya ditetapkan sebelum pembangunan dan boleh dirundingkan serta ditetapkan dengan ahli pasukan anda.
Nama pembolehubah
Adalah disyorkan untuk menggunakan camelCase untuk nama berubah:
firstName = "John";
lastName = "Doe";
harga = 19.90;
cukai = 0.20;
harga penuh = harga + (harga * cukai);
Angkasa dan operator
Pengendali biasa ( = + - * / ) Anda perlu menambah ruang sebelum dan selepas:
Contoh:
var x = y + z;
var values = ["Volvo", "Saab", " Fiat" ];
Lekukan kod
Biasanya menggunakan 4 ruang untuk mengesot blok kod:
Fungsi:
fungsi keCelsius(fahrenheit) {
return (5 / 9) * (fahrenheit - 32);
}
Tidak disyorkan untuk menggunakan kekunci TAB untuk menyingkat Kerana editor berbeza mentafsir kunci TAB secara berbeza.
Peraturan pernyataan
Peraturan am untuk pernyataan mudah:
Sesuatu pernyataan biasanya berakhir dengan simbol.
Contoh:
var values = ["Volvo", "Saab", "Fiat"];
var person = {
firstName: "John ",
Nama Akhir: "Doe",
umur: 50,
Warna mata: "biru"
};
Peraturan am untuk pernyataan kompleks:
akan dibelanjakan di sebelah kiri Tanda kurung diletakkan di hujung baris pertama.
Tambah ruang sebelum pendakap kerinting kiri.
Letakkan pendakap kerinting penutup pada barisnya sendiri.
Jangan tamatkan pernyataan kompleks dengan koma bertitik.
Fungsi:
fungsi keCelsius(fahrenheit) {
kembali (5 / 9) * (fahrenheit - 32);
}
Gelung:
untuk (i = 0; i < 5; i++) {
x += i;
}
Pernyataan bersyarat:
jika (masa < 20) {
salam = "Selamat hari";
} lain {
salam = "Selamat petang";
}
Peraturan objek
Peraturan untuk definisi objek:
Letakkan pendakap kerinting pembuka pada baris yang sama dengan nama kelas.
Terdapat ruang antara titik bertindih dan nilai atribut.
Gunakan petikan berganda untuk rentetan, tetapi bukan untuk nombor.
Jangan tambahkan koma selepas pasangan atribut-nilai terakhir.
Letakkan pendakap kerinting kanan pada barisnya sendiri dan akhiri dengan simbol.
Contoh:
var person = {
firstName: "John",
lastName: "Doe",
umur: 50,
eyeColor: "blue "
};
Kod objek pendek boleh ditulis terus dalam satu baris:
Contoh:
var person = {firstName:"John", lastName: "Doe" , umur:50, eyeColor:"blue"};
Aksara setiap baris kod hendaklah kurang daripada 80
Untuk memudahkan pembacaan, adalah disyorkan bahawa aksara setiap baris hendaklah kurang daripada 80.
Jika pernyataan JavaScript melebihi 80 aksara, adalah disyorkan untuk memutuskan baris selepas operator atau koma.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<h1>我的 Web 页面</h1>
<p>
建议在运算符或者逗号后换行。
</p>
<p id="demo"></p>
<script>
document.getElementById("demo").innerHTML =
"Hello php.";
</script>
</body>
</html>Peraturan penamaan
Secara amnya, peraturan penamaan banyak bahasa kod adalah serupa, contohnya:
Pembolehubah dan fungsi ialah camelCase
Pembolehubah global ialah huruf besar (HURUF BESAR)
Pemalar (seperti PI) ialah huruf besar (HURUF BESAR)
Adakah anda menggunakan peraturan ini untuk penamaan pembolehubah: hyp-hens, camelCase , atau under_scores ?
Bar (-) aksara dalam HTML dan CSS:
Atribut HTML5 boleh diawali dengan data- (cth: data-kuantiti, data-price).
Penggunaan CSS - untuk menggabungkan nama sifat (saiz fon).
- biasanya dianggap sebagai penolakan dalam JavaScript, jadi tidak dibenarkan.
Underscore:
Ramai pengaturcara lebih suka menggunakan garis bawah (seperti: date_of_birth), terutamanya dalam pangkalan data SQL.
Bahasa PHP biasanya menggunakan garis bawah.
PascalCase:
PascalCase lebih biasa dalam bahasa C.
Sarung unta:
Sarung unta biasanya disyorkan dalam JavaScript, dan jQuery serta perpustakaan JavaScript lain menggunakan sarung unta.
Jangan mulakan nama pembolehubah dengan $ kerana ia akan bercanggah dengan banyak perpustakaan JavaScript.
HTML Muatkan fail JavaScript luaran
Muat fail JavaScript menggunakan format ringkas (jenis atribut tidak diperlukan):
< ;script src ="myscript.js">
Menggunakan JavaScript untuk mengakses elemen HTML
HTML yang tidak diformatkan dengan baik boleh menyebabkan ralat pelaksanaan JavaScript.
Dua pernyataan JavaScript berikut akan mengeluarkan hasil yang berbeza:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<p id="Demo">段落 1。</p>
<p id="demo">段落 2。</p>
<script>
// 只有段落 2 会被替换
document.getElementById("demo").innerHTML = "HELLO.";
</script>
</body>
</html>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) 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.
bahagian seterusnya