微信小程序之項目結構與配置

每個平臺項目都有相應的項目結構與配置,一起來看一下微信小程序的項目結構。
文件結構
小程序包含一個描述整體程序的 app 和多個描述各自頁面的 page。
一個小程序主體部分由三個文件組成,必須放在項目的根目錄,如下:
這裏寫圖片描述
一個小程序頁面由四個文件組成,分別是:
這裏寫圖片描述
項目結構如下:
這裏寫圖片描述

項目配置
一個項目的大體結構就如上所示,下面來看看具體配置:
使用app.json文件來對微信小程序進行全局配置,決定頁面文件的路徑、窗口表現、設置網絡超時時間、設置多 tab 等。

{
  "pages": [
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#000fff",
    "navigationBarTitleText": "微信小程序",
    "navigationBarTextStyle": "white",
    "backgroundColor": "#ffffff"
  },
  "tabBar": {
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "首頁",
        "iconPath": "pages/assests/imgs/home_normal.png",
        "selectedIconPath": "pages/assests/imgs/home_pressed.png",
        "color": "#000000",
        "selectedColor": "#CED63A"
      },
      {
        "pagePath": "pages/logs/logs",
        "text": "第二頁",
        "iconPath": "pages/assests/imgs/second_normal.png",
        "selectedIconPath": "pages/assests/imgs/second_pressed.png",
        "color": "#000000",
        "selectedColor": "#CED63A"

      }
    ]
  },
  "networkTimeout": {
    "request": 20000,
    "connectSocket": 20000,
    "uploadFile": 20000,
    "downloadFile": 20000
  },
  "debug": true
}

app.json 配置項列表
這裏寫圖片描述

pages

接受一個數組,每一項都是字符串,來指定小程序由哪些頁面組成。每一項代表對應頁面的【路徑+文件名】信息,數組的第一項代表小程序的初始頁面。小程序中新增/減少頁面,都需要對 pages 數組進行修改。
文件名不需要寫文件後綴,因爲框架會自動去尋找路徑.json,.js,.wxml,.wxss的四個文件進行整合。
如開發目錄爲:
pages/
pages/index/index.wxml
pages/index/index.js
pages/index/index.wxss
pages/logs/logs.wxml
pages/logs/logs.js
app.js
app.json
app.wxss
則,我們需要在 app.json 中寫
{
“pages”:[
“pages/index/index”
“pages/logs/logs”
]
}

window

用於設置小程序的狀態欄、導航條、標題、窗口背景色。
這裏寫圖片描述
注:HexColor(十六進制顏色值),如”#000fff”

 "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#000fff",
    "navigationBarTitleText": "微信小程序",
    "navigationBarTextStyle": "white",
    "backgroundColor": "#dddeee"
  }

官方一張圖大家參考:
這裏寫圖片描述
tabBar

如果我們的小程序是一個多 tab 應用(客戶端窗口的底部或頂部有 tab 欄可以切換頁面),那麼我們可以通過 tabBar 配置項指定 tab 欄的表現,以及 tab 切換時顯示的對應頁面。
Tip: 通過頁面跳轉(wx.navigateTo)或者頁面重定向(wx.redirectTo)所到達的頁面,即使它是定義在 tabBar 配置中的頁面,也不會顯示底部的 tab 欄。
tabBar 是一個數組,只能配置最少2個、最多5個 tab,tab 按數組的順序排序。
屬性說明:
這裏寫圖片描述

其中 list 接受一個數組,數組中的每個項都是一個對象,其屬性值如下:
這裏寫圖片描述

這裏寫圖片描述
networkTimeout

可以設置各種網絡請求的超時時間。
屬性說明:
這裏寫圖片描述

debug
可以在開發者工具中開啓 debug 模式,在開發者工具的控制檯面板,調試信息以 info 的形式給出,其信息有Page的註冊,頁面路由,數據更新,事件觸發 。 可以幫助開發者快速定位一些常見的問題。

page.json
每一個小程序頁面也可以使用.json文件來對本頁面的窗口表現進行配置。 頁面的配置比app.json全局配置簡單得多,只是設置 app.json 中的 window 配置項的內容,頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。

頁面的.json只能設置 window 相關的配置項,以決定本頁面的窗口表現,所以無需寫 window 這個鍵,如:
這裏寫圖片描述

{
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#000fff",
    "navigationBarTitleText": "查看啓動日誌",
    "navigationBarTextStyle": "white",
    "backgroundColor": "#ffffff"
  }

根據以上所說,看個簡單gif圖:
這裏寫圖片描述

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章