此外,JavaScript 的注釋有兩種"http://" 和"/* .... */",建議"http://"用作代碼行注釋,"/* .... */"形式用作對整個(gè)代碼段的注銷,或較正式的聲明中,如函數(shù)參數(shù)、功能、文件功能等的描述中。
標(biāo)識符命名
JavaScript 中的標(biāo)識符的命名規(guī)則:
- 以字母、下劃線'_'或美元符號'$'開頭
- 允許名稱中包含字母,數(shù)字,下劃線'_'和美元符號'$'
- 區(qū)分大小寫
變量、參數(shù)、成員變量、函數(shù)等名稱均以小寫字母開頭,構(gòu)造器的名稱以大寫字母開頭。下劃線'_'開頭的變量一般習(xí)慣于標(biāo)識私有 / 局部成員。而美元符號'$'開頭的變量習(xí)慣于標(biāo)識系統(tǒng)相關(guān),比如系統(tǒng)進(jìn)程等。應(yīng)避免用下劃線'_'或美元符號'$'來命名標(biāo)識符。盡可能地降低代碼的閱讀負(fù)擔(dān)。
聲明
變量的聲明
盡管 JavaScript 語言并不要求在變量使用前先對變量進(jìn)行聲明。但我們還是應(yīng)該養(yǎng)成這個(gè)好習(xí)慣。這樣可以比較容易的檢測出那些未經(jīng)聲明的變量,避免其變?yōu)殡[藏的全局變量,造成隱患。
在函數(shù)的開始應(yīng)先用 var 關(guān)鍵字聲明函數(shù)中要使用的局部變量,注釋變量的功能及代表的含義,且應(yīng)以字母順序排序。每個(gè)變量單獨(dú)占一行,以便添加注釋。這是因?yàn)?JavaScript 中只有函數(shù)的 {} 表明作用域,用 var 關(guān)鍵字聲明的局部變量只在函數(shù)內(nèi)有效,而未經(jīng) var 聲明的變量則被視為全局變量。我們來看下清單 3。
清單 3. 局部變量聲明
<script language="javascript"> var valueA = "a"; var valueB = "b"; function f1() { var valueA = "c"; alert("valueA="+valueA); //output: valueA=c valueB = "d"; alert("valueB="+valueB); //output: valueB=d } f1(); alert("valueA="+valueA); //output: valueA=a alert("valueB="+valueB); //output: valueB=d </script>
從上例的輸出驚奇地發(fā)現(xiàn),用 var 聲明過的變量 valueA 和沒有聲明的變量 valueB 是有區(qū)別的。特別需要注意的是,在函數(shù)內(nèi)部用 var 聲明的變量為局部變量,這樣可以有效地避免因局部變量和全局變量同名而產(chǎn)生的錯(cuò)誤。
函數(shù)的聲明
函數(shù)也應(yīng)在調(diào)用前進(jìn)行聲明,內(nèi)部函數(shù)應(yīng)在 var 聲明內(nèi)部變量的語句之后聲明,可以清晰地表明內(nèi)部變量和內(nèi)部函數(shù)的作用域。
此外,函數(shù)名緊接左括號'('之間,而右括號')'和后面的'{'之間要有個(gè)空格,以清楚地顯示函數(shù)名以其參數(shù)部分,和函數(shù)體的開始。若函數(shù)為匿名 / 無名函數(shù),則 function 關(guān)鍵字和左括號'('之間要留空格,否則可能誤認(rèn)為該函數(shù)的函數(shù)名為 function。
清單 4. 內(nèi)部函數(shù)聲明
<script language="javascript"> var innerA = 1; function outF() { var innerA = 2; function _inF() { alert("valueA="+innerA); } _inF(); } outF(); //output: valueA=2 _inF(); //error: innerF is not defined </script>
從清單 4 的輸出可以看出,inF() 函數(shù)僅在 outF() 函數(shù)的內(nèi)部生效,局部變量 innerA 對內(nèi)部函數(shù)的作用域生效。這樣的編碼方式使得變量和函數(shù)的作用域變得清晰。
出處:ibm
責(zé)任編輯:bluehearts
上一頁 淺談JavaScript編程語言的編碼規(guī)范 [2] 下一頁 淺談JavaScript編程語言的編碼規(guī)范 [4]
◎進(jìn)入論壇網(wǎng)頁制作、WEB標(biāo)準(zhǔn)化版塊參加討論,我還想發(fā)表評論。
|