當前位置:成語大全網 - 漢語詞典 - Aisi軟件:前端開發規範文檔

Aisi軟件:前端開發規範文檔

開發規範(前端)

版本:v1.0

日期:2022-01-15

壹:命名規範

英文單詞在命名中的使用簡單易懂。

項目命名

使用小寫字母,多個單詞用“-”拼接。

比如:我的世界/世界

文件夾命名

使用小寫字母,多個單詞用“-”拼接。

例如:主頁/主頁

文件命名

使用小寫字母,多個單詞用“-”拼接。

例如:主頁/主頁

變量命名

以壹個小駝峰命名。如果壹個文件中有太多變量,可能會有重名。建議添加前綴,以區分不同功能的變量。或將變量拆分到不同的文件中。

示例:最大高度/用戶最大高度/家庭最大高度。

常數命名

全部使用大寫字母。多個單詞由下劃線“_”分隔。

例如:const user _ type = " 9001 ";

函數命名

規範1:用小駝峰命名。繼承的父類的私有函數需要以下劃線“_getPrice()”為前綴。

例如:showToast/_getPrice

規範2:根據功能適當添加動詞前綴。

例如:getSize/setSize/hasNumber。

前綴請參考文檔底部的“附錄1:(函數命名動詞前綴集成)”。

第二:註釋規範

通俗易懂的變量方法,盡量寫註釋。復雜變量方法,必須寫註釋。

單行註釋//

在代碼頂行寫壹行註釋,下面簡單介紹代碼的用途和註意事項。

多行註釋/* */或/* */

方法必須使用多行註釋。當變量或代碼塊比較復雜,單行註釋不足以解釋清楚時,也需要多行註釋。

例如:

//商品名稱

商品名稱:“獼猴桃”,

/**

*錄入人員姓名,從數據庫中查詢該人員的手機號碼。

* @param {String}用戶名

* @return {Number}手機號碼

*/

getUserMobile(用戶名){

......

歸還手機;

},

三:CSS規範

1.類類名用小寫字母,多個單詞用“-”拼接。

2.ID是以壹個小駝峰命名的。

3.SCSS及以下的變量、函數和混合都用小駝峰命名。

4.縮進整齊有序。

四:項目規格

項目結構的建議說明(根據具體需求邏輯實際調整)

科學研究委員會

Api所有接口封裝

Asstes資源文件

-圖像圖片

-視頻

組件所有組件

路由器路由

商店狀態管理

樣式樣式

Utils公共函數庫

視圖視圖

-主視圖文件需要存儲在模塊和文件夾中

home.vue

主頁-詳細信息.視圖

-用戶

五:附件

附錄1:(函數命名動詞前綴集成)