JavaScript 代碼規範

所有的 JavaScript 項目適用同一種規範。

JavaScript 代碼規範

代碼規範通常包括以下幾個方面:

• 變數和函數的命名規則

• 空格，縮進，注釋的使用規則。

• 其他常用規範……

規範的代碼可以更易於閱讀與維護。

代碼規範一般在開發前規定，可以跟你的團隊成員來協商設置。

變數名

變數名推薦使用駝峰法來命名(camelCase):

firstName = "John";

lastName = "Doe";

price = 19.90;

tax = 0.20;

fullPrice = price + (price * tax);

空格與運算符

通常運算符 ( = + - * / ) 前後需要添加空格:

實例:

var x = y + z;

var values = ["Volvo", "Saab", "Fiat"];

代碼縮進

通常使用 4 個空格符號來縮進代碼塊：

函數:

function toCelsius(fahrenheit) {

return (5 / 9) * (fahrenheit - 32);

}

語句規則

簡單語句的通用規則:

• 一條語句通常以分號作為結束符。

實例:

var values = ["Volvo", "Saab", "Fiat"];

var person = {

firstName: "John",

lastName: "Doe",

age: 50,

eyeColor: "blue"

};

複雜語句的通用規則:

• 將左花括弧放在第一行的結尾。

• 左花括弧前添加一空格。

• 將右花括弧獨立放在一行。

• 不要以分號結束一個複雜的聲明。

函數:

function toCelsius(fahrenheit) {

return (5 / 9) * (fahrenheit - 32);

}

循環:

for (i = 0; i < 5; i++) {

x += i;

}

條件語句:

if (time < 20) {

greeting = "Good day";

} else {

greeting = "Good evening";

}

對象規則

對象定義的規則:

• 將左花括弧與類名放在同一行。

• 冒號與屬性值間有個空格。

• 字元串使用雙引號，數字不需要。

• 最後一個屬性-值對後面不要添加逗號。

• 將右花括弧獨立放在一行，並以分號作為結束符號。

實例:

var person = {

firstName: "John",

lastName: "Doe",

age: 50,

eyeColor: "blue"

};

短的對象代碼可以直接寫成一行:

實例:

var person = {firstName:"John", lastName:"Doe", age:50, eyeColor:"blue"};

每行代碼字元小於 80

為了便於閱讀每行字元建議小於數 80 個。

如果一個 JavaScript 語句超過了 80 個字元，建議在 運算符或者逗號後換行。

實例:

document.getElementById("demo").innerHTML =

"Hello Runoob.";

命名規則

一般很多代碼語言的命名規則都是類似的，例如:

• 變數和函數為駝峰法（ camelCase）

• 全局變數為大寫 (UPPERCASE)

• 常量 (如 PI) 為大寫 (UPPERCASE)

變數命名你是否使用這幾種規則： hyp-hens, camelCase, 或 under_scores ?

HTML 和 CSS 的橫杠(-)字元:

HTML5 屬性可以以 data- (如：data-quantity, data-price) 作為前綴。

CSS 使用 - 來連接屬性名 (font-size)。

下劃線:

很多程序員比較喜歡使用下劃線(如：date_of_birth), 特別是在 SQL 資料庫中。

PHP 語言通常都使用下劃線。

帕斯卡拼寫法(PascalCase):

帕斯卡拼寫法(PascalCase) 在 C 語言中語言較多。

駝峰法：

JavaScript 中通常推薦使用駝峰法，jQuery 及其他 JavaScript 庫都使用駝峰法。

HTML 載入外部 JavaScript 文件

使用簡潔的格式載入 JavaScript 文件 ( type 屬性不是必須的):