下面以開發者工具自動生成的程序框架為例,對小程序的框架進行介紹。
選擇一個空的項目目錄創建一個小程序項目,如下圖:
創建完成后我們看到如下目錄結構:
目錄結構

小程序包含一個描述整體程序的 app 和多個描述各自頁面的 page。
一個小程序主體部分由三個文件組成,必須放在項目的根目錄,如下:
| 文件 | 必須 | 作用 |
|---|---|---|
| app.js | 是 | 小程序邏輯 |
| app.json | 是 | 小程序公共設置 |
| app.wxss | 否 | 小程序公共樣式表 |
pages目錄下為小程序頁面,每個頁面須建立獨立的文件夾,例如上面生成的小程序有兩個頁面,分別為pages/index、pages/logs,一個頁面由四個文件組成,分別是:
| 文件類型 | 必須 | 作用 |
|---|---|---|
| js | 是 | 頁面邏輯 |
| wxml | 是 | 頁面結構 |
| wxss | 否 | 頁面樣式表 |
| json | 否 | 頁面配置 |
配置
app.json文件來對微信小程序進行全局配置,決定頁面文件的路徑、窗口表現、設置網絡超時時間、設置多 tab 等。
例子中的配置文件內容如下:
{ "pages":[ "pages/index/index", "pages/logs/logs" ], "window":{ "backgroundTextStyle":"light", "navigationBarBackgroundColor": "#fff", "navigationBarTitleText": "WeChat", "navigationBarTextStyle":"black" }}app.json共提供了以下配置項:
| 屬性 | 類型 | 必填 | 描述 |
|---|---|---|---|
| pages | String Array | 是 | 設置頁面路徑 |
| window | Object | 否 | 設置默認頁面的窗口表現 |
| tabBar | Object | 否 | 設置底部 |
| networkTimeout | Object | 否 | 設置網絡超時時間 |
| debug | Boolean | 否 | 設置是否開 |
接受一個數組,每一項都是字符串,來指定小程序由哪些頁面組成。每一項代表對應頁面的【路徑+文件名】信息,數組的第一項代表小程序的初始頁面。小程序中新增/減少頁面,都需要對 pages 數組進行修改。
window
用于設置小程序的狀態欄、導航條、標題、窗口背景色。
| 屬性 | 類型 | 默認值 | 描述 |
|---|---|---|---|
| navigationBarBackgroundColor | HexColor | 000000 | 導航欄背景顏色,如”#000000” |
| navigationBarTextStyle | String | white | 導航欄標題顏色,僅支持 black/white |
| navigationBarTitleText | String | 導航欄標題文字內容 | |
| backgroundColor | HexColor | ffffff | 窗口的背景色 |
| backgroundTextStyle | String | dark | 下拉背景字體、loading 圖的樣式,僅支持 dark/light |
| enablePullDownRefresh | Boolean | false | 是否開啟下拉刷新,詳見頁面相關事件處理函數。 |
tabBar
如果我們的小程序是一個多 tab 應用(客戶端窗口的底部有tab欄可以切換頁面),那么我們可以通過 tabBar 配置項指定 tab 欄的表現,以及 tab 切換時顯示的對應頁面。
tabBar 是一個數組,只能配置最少2個、最多5個 tab,tab 按數組的順序排序。
| 屬性 | 類型 | 默認值 | 描述 |
|---|---|---|---|
| color | HexColor | 是 | tab 上的文字默認顏色 |
| selectedColor | HexColor | 是 | tab 上的文字選中時的顏色 |
| backgroundColor | HexColor | 是 | tab 的背景色 |
| borderStyle | String | 否 | black tabbar上邊框的顏色, 僅支持 black/white |
| list | Array | 是 | tab 的列表,詳見 list 屬性說明,最少2個、最多5個 tab |
| position | String | 否 | bottom 可選值 bottom、top |
其中 list 接受一個數組,數組中的每個項都是一個對象,其屬性值如下:
| 屬性 | 類型 | 必填 | 說明 |
|---|---|---|---|
| pagePath | String | 是 | 頁面路徑,必須在 pages 中先定義 |
| text | String | 是 | tab 上按鈕文字 |
| iconPath | String | 是 | 圖片路徑,icon 大小限制為40kb |
| selectedIconPath | String | 是 | 選中時的圖片路徑,icon 大小限制為40kb |
可以設置各種網絡請求的超時時間。
屬性說明:
| 屬性 | 類型 | 必填 | 說明 |
|---|---|---|---|
| request | Number | 否 | wx.request的超時時間,單位毫秒 |
| connectSocket | Number | 否 | wx.connectSocket的超時時間,單位毫秒 |
| uploadFile | Number | 否 | wx.uploadFile的超時時間,單位毫秒 |
| downloadFile | Number | 否 | wx.downloadFile的超時時間,單位毫秒 |
可以在開發者工具中開啟 debug 模式,在開發者工具的控制臺面板,調試信息以 info 的形式給出,其信息有Page的注冊,頁面路由,數據更新,事件觸發 。
page.json
每一個小程序頁面也可以使用.json文件來對本頁面的窗口表現進行配置。 頁面的配置比app.json全局配置簡單得多,只是設置 app.json 中的 window 配置項的內容,頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。
頁面的.json只能設置 window 相關的配置項,以決定本頁面的窗口表現,所以無需寫 window 這個鍵,如:
{ "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "navigationBarTitleText": "微信接口功能演示", "backgroundColor": "#eeeeee", "backgroundTextStyle": "light"}感謝閱讀,希望能幫助到大家,謝謝大家對本站的支持!
新聞熱點
疑難解答