javascript
JavaScript 代码规范
所有的 JavaScript 項目適用同一種規范。
JavaScript 代碼規范
代碼規范通常包括以下幾個方面:
- 變量和函數的命名規則
- 空格,縮進,注釋的使用規則。
- 其他常用規范……
規范的代碼可以更易于閱讀與維護。
代碼規范一般在開發前規定,可以跟你的團隊成員來協商設置。
變量名
變量名推薦使用駝峰法來命名(camelCase):
firstName = "John"; lastName = "Doe"; price = 19.90; tax = 0.20; fullPrice = price + (price * tax);在JavaScript中定義變量名時,還應該注意以下事項:
- 變量名應該區分大小寫,允許包含字母、數字、美元符號($)和下劃線,但第一個字符不允許是數字,不允許包含空格和其他標點符號;
- 變量命名長度應該盡可能的短,并抓住要點,盡量在變量名中體現出值的類型;
- 變量名的命名應該是有意義的;
- 變量名不能為JavaScript中的關鍵詞、保留字全名;
- 變量名命名方法常見的有匈牙利命名法、駝峰命名法和帕斯卡命名法。
空格與運算符
通常運算符 ( = + - * / ) 前后需要添加空格:
實例:
var x = y + z; var values = ["Volvo", "Saab", "Fiat"];代碼縮進
通常使用 4 個空格符號來縮進代碼塊:
函數:
function toCelsius(fahrenheit) { return (5 / 9) * (fahrenheit - 32); }注意:不推薦使用 TAB 鍵來縮進,因為不同編輯器 TAB 鍵的解析不一樣。
?
語句規則
簡單語句的通用規則:
- 一條語句通常以分號作為結束符。
實例:
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 W3Cschool.";
嘗試一下 ?
注意:在函數聲明、函數表達式、函數調用、對象創建、數組創建、for?語句等場景中,不允許在?,?或?;?前換行。
命名規則
一般很多代碼語言的命名規則都是類似的,例如:
- 變量和函數為駝峰法( camelCase)
- 全局變量為大寫 (UPPERCASE )
- 常量 (如 PI) 為大寫 (UPPERCASE )
變量命名你是否使用這幾種規則: hyp-hens, camelCase, 或under_scores ?
HTML 和 CSS 的橫杠(-)字符:
HTML5 屬性可以以 data- (如:data-quantity, data-price) 作為前綴。
CSS 使用 - 來連接屬性名 (font-size)。
注意:- 通常在 JavaScript 中被認為是減法,所以不允許使用。
下劃線:
很多程序員比較喜歡使用下劃線(如:date_of_birth), 特別是在 SQL 數據庫中。
PHP 語言通常都使用下劃線。
帕斯卡拼寫法(PascalCase):
帕斯卡拼寫法(PascalCase) 在 C 語言中語言較多。
駝峰法:
JavaScript 中通常推薦使用駝峰法,jQuery 及其他 JavaScript 庫都使用駝峰法。
注意:變量名不要以 $ 作為開始標記,會與很多 JavaScript 庫沖突。
?
HTML 載入外部 JavaScript 文件
使用簡潔的格式載入 JavaScript 文件 ( type 屬性不是必須的):
<script src="myscript.js">使用 JavaScript 訪問 HTML 元素
一個糟糕的 HTML 格式可能會導致 JavaScript 執行錯誤。
以下兩個 JavaScript 語句會輸出不同結果:
實例
var obj =getElementById("Demo")var obj = getElementById("demo")
嘗試一下 ?
HTML 與 JavaScript 盡量使用相同的命名規則。
訪問 HTML(5) 代碼規范。
文件擴展名
HTML 文件后綴可以是 .html (或r .htm)。
CSS 文件后綴是 .css 。
JavaScript 文件后綴是 .js 。
使用小寫文件名
大多 Web 服務器 (Apache, Unix) 對大小寫敏感: london.jpg 不能通過 London.jpg 訪問。
其他 Web 服務器 (Microsoft, IIS) 對大小寫不敏感: london.jpg 可以通過 London.jpg 或 london.jpg 訪問。
你必須保持統一的風格,我們建議統一使用小寫的文件名。
轉載于:https://www.cnblogs.com/navysummer/p/8438938.html
創作挑戰賽新人創作獎勵來咯,堅持創作打卡瓜分現金大獎總結
以上是生活随笔為你收集整理的JavaScript 代码规范的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 《我是特种兵》里面的真实夫妻 侯梦莎的老
- 下一篇: javascript如何阻止事件冒泡和默