1、小程序文件結構和傳統web對比
結構 | 傳統web | 微信小程序 |
---|---|---|
結構 | HTML | WXML |
樣式 | CSS | WXSS |
邏輯 | JavaScript | JavaScript |
配置 | 無 | JSON |
2、基本的項目目錄
3、小程序配置文件
一個小程序應用程序會包括最基本的兩種配置文件。一種是全局的app.json和頁面自己的page.json
全局配置app.json
app.json是當前小程序的全局配置,包括了小程序的所有頁面路徑、界面表現、網絡超時時間、底部tab等。普通快速啓動項目裏邊的app.json配置:
{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle":"black"
}
}
字段含義:
- pages字段:用於描述當前小程序所有頁面路徑,這是爲了讓微信客戶端知道當前的小程序頁面定義在哪個目錄。
- window字段:定義小程序所有頁面的頂部背景顏色,文字顏色定義等。
- 完整的配置信息參考app.json配置
頁面配置page.json
這裏的page.json其實用來表示頁面目錄下的page.json這類和小程序頁面相關的配置。
開發者可以獨立定義每個頁面的一些屬性,如頂部顏色、是否允許下拉刷新等等。
頁面的配置只能設置app.json中部分window配置項的內容。
頁面中配置項會覆蓋app.json的window中相同的配置項。
屬性 | 類型 | 默認值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 導航欄背景顏色,如 #000000 |
navigationBarTextStyle | String | white | 導航欄標題顏色,僅支持 black / white |
navigationBarTitleText | String | 導航欄標題文字內容 | |
backgroundColor | HexColor | #ffffff | 窗口的背景色 |
backgroundTextStyle | String | dark | 下拉 loading 的樣式,僅支持 dark / light |
enablePullDownRefresh | Boolean | false | 是否全局開啓下拉刷新。 詳見 Page.onPullDownRefresh |
onReachBottomDistance | Number | 50 | 頁面上拉觸底事件觸發時距頁面底部距離,單位爲px。 詳見 Page.onReachBottom |
disableScroll | Boolean | false | 設置爲 true 則頁面整體不能上下滾動;只在頁面配置中有效,無法在 app.json 中設置該項 |
sitemap 配置-瞭解即可
小程序根目錄下的sitemap.json文件用於配置小程序及其頁面是否允許被微信索引。