前臺(tái)編碼規(guī)范(Html,JS,CSS).docx

4、.3排版·HTML標(biāo)記內(nèi)部，不允許出現(xiàn)空行及無意義的空格?！?yīng)正確使用縮進(jìn)來呈現(xiàn)嵌套關(guān)系，子元素應(yīng)比父級(jí)元素縮進(jìn)一個(gè)制表位。但僅有內(nèi)容無子標(biāo)簽的元素，可在同一行書寫，例如“Save”?！と鐦?biāo)簽屬性過多過長，可適當(dāng)在標(biāo)簽內(nèi)部換行，但同一頁面，同類標(biāo)簽應(yīng)采用大致相同的換行策略，切忌五花八門。2.4CSHTML·向控件賦值應(yīng)盡量直接使用標(biāo)準(zhǔn)的Model，ViewData或ViewBag，如非必要，不要使用@{}嵌入塊，尤其是不要在嵌入塊中進(jìn)行無意義的重復(fù)引用，例如“@{vartest=@ViewBag.Test;}”?！Html生成器存在多個(gè)

5、兼容性問題，應(yīng)謹(jǐn)慎使用，簡單的控件應(yīng)盡可能使用原生html標(biāo)簽。例如@Html.DropDownList在綁定已有選中值的數(shù)據(jù)源時(shí)，會(huì)丟失已選中項(xiàng)。3JS3.1組織·應(yīng)盡可能將JS代碼寫入獨(dú)立的JS文件中，而不要直接嵌入頁面，以增強(qiáng)緩存利用率及可維護(hù)性?！は嗤蝾愃扑惴☉?yīng)盡可能統(tǒng)一到同一個(gè)方法中，以提高可維護(hù)性。尤其是不允許在Creat和Edit頁面之間直接Copy相關(guān)JS代碼。·在頁面中引用JS文件時(shí)，應(yīng)將引用標(biāo)簽寫在標(biāo)簽之后?！ろ?xiàng)目正式發(fā)布時(shí)，應(yīng)將所有JS文件轉(zhuǎn)化為mini版本。3.2命名·文件名全部小寫（詞匯縮寫也小寫），各單詞間用“-”為連接符。例如“

6、jquery-overlay-1.0.js”·方法名，變量名均采用駱駝命名法，第一個(gè)單詞小寫，之后的單詞首字母大寫，各單詞間不加任何連接符。例如“userId”·所有變量及方法名都應(yīng)見名知義，除i,j,k等約定俗成用于集合遍歷的臨時(shí)變量名以外，不允許使用無意義的單個(gè)字母做為變量名或方法名。3.3變量·JS有著非常糟糕的內(nèi)存及作用域管理機(jī)制，如非絕對(duì)必要，不要聲明全局變量。3.4方法·為提高兼容性，盡可能少使用returnfalse;應(yīng)以e.preventDefault();代替。3.5對(duì)象及控件·公司目前無專職前臺(tái)工程師，JS平均水平偏低。而JS自定義對(duì)象及控件語法比較復(fù)

7、雜，為增強(qiáng)項(xiàng)目可維護(hù)性，應(yīng)盡量避免使用自定義對(duì)象及控件，在必要情況下，也應(yīng)先與整個(gè)團(tuán)隊(duì)協(xié)商。3.6第三方庫·為增強(qiáng)可維護(hù)性，原則上各項(xiàng)目都采用Jquery或AngularJSframework為基礎(chǔ)庫，以確保所有人都能看懂相關(guān)代碼?！ぴ陧?xiàng)目中引入第三方JS插件時(shí)，應(yīng)與整個(gè)團(tuán)隊(duì)協(xié)商，并認(rèn)真評(píng)估兼容性。·如無絕對(duì)正當(dāng)?shù)睦碛?，同一個(gè)項(xiàng)目中，不應(yīng)該出現(xiàn)同一JS庫的不同版本?！ろ?xiàng)目中引用的任何第三方JS文件均應(yīng)存放于獨(dú)立文件夾中，并不得直接修改原始文件，如果需要擴(kuò)充或修改第三方API，應(yīng)寫在另外的文件中。如引用的第三方JS庫較多，應(yīng)在項(xiàng)