uni-app入門(uni-app專案結構介紹、pages.json配置項列表)
阿新 • • 發佈:2020-10-13
一、uni-app專案結構
上一篇部落格咱們介紹瞭如何建立一個uni-app專案,專案建立完成後的目錄樣式如圖所示:
- pages 業務頁面檔案存放的目錄
pages裡面可以存放.vue的頁面,如下圖所示:index的頁面
-
static 存放應用引用靜態資源(如圖片、視訊等)的目錄,注意:靜態資源只能存放於此
-
App.vue 應用配置,用來配置App全域性樣式以及監聽 應用生命週期
-
main.js Vue初始化入口檔案
-
manifest.json 配置應用名稱、appid、logo、版本等打包資訊
-
pages.json 配置頁面路由、導航條、選項卡等頁面類資訊
二、pages.json配置項列表
下面只介紹幾個常用的屬性,如需其他熟悉可檢視uni-app的官方文件
屬性 | 型別 | 必填 | 描述 |
---|---|---|---|
pages | Object Array | 是 | 設定頁面路徑及視窗表現 |
globalStyle | Object | 否 | 設定預設頁面的視窗表現 |
tabBar | Object | 否 | 設定底部 tab 的表現 |
condition | Object | 否 | 啟動模式配置 |
- globalStyle
用於設定應用的狀態列、導航條、標題、視窗背景色等。
屬性 | 型別 | 預設值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #F7F7F7 | 導航欄背景顏色(同狀態列背景色) |
navigationBarTextStyle | String | white | 導航欄標題顏色及狀態列前景顏色,僅支援 black/white |
navigationBarTitleText | String | 導航欄標題文字內容 | |
navigationStyle | String | default | 導航欄樣式,僅支援 default/custom。custom即取消預設的原生導航欄 |
backgroundColor | HexColor | #ffffff | 下拉顯示出來的視窗的背景色 |
backgroundTextStyle | String | dark | 下拉 loading 的樣式,僅支援 dark / light |
enablePullDownRefresh | Boolean | false | 是否開啟下拉重新整理 |
onReachBottomDistance | Number | 50 | 頁面上拉觸底事件觸發時距頁面底部距離,單位只支援px |
- pages
uni-app 通過 pages 節點配置應用由哪些頁面組成,pages 節點接收一個數組,陣列每個項都是一個物件,其屬性值如下:
屬性 | 型別 | 預設值 | 描述 |
---|---|---|---|
path | String | 配置頁面路徑 | |
style | Object | 配置頁面視窗表現 (詳細檢視下面pages下style的屬性) |
注意:
pages節點的第一項為應用入口頁(即首頁)
應用中新增/減少頁面,都需要對 pages 陣列進行修改
檔名不需要寫字尾,框架會自動尋找路徑下的頁面資源
- pages下style的屬性:
用於設定每個頁面的狀態列、導航條、標題、視窗背景色等。
頁面中配置項會覆蓋 globalStyle 中相同的配置項
屬性 | 型別 | 預設值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 導航欄背景顏色(同狀態列背景色) |
navigationBarTextStyle | String | white | 導航欄標題顏色及狀態列前景顏色,僅支援 black/white |
navigationBarTitleText | String | 導航欄標題文字內容 | |
navigationBarShadow | Object | 導航欄陰影 | |
navigationStyle | String | default | 導航欄樣式,僅支援 default/custom。custom即取消預設的原生導航欄 |
backgroundColor | HexColor | #ffffff | 視窗的背景色 |
backgroundTextStyle | String | dark | 下拉 loading 的樣式,僅支援 dark/light |
enablePullDownRefresh | Boolean | false | 是否開啟下拉重新整理 |
onReachBottomDistance | Number | 50 | 頁面上拉觸底事件觸發時距頁面底部距離,單位只支援px |
注意:視窗的背景色backgroundColor,只有在開啟下拉重新整理時(enablePullDownRefresh:true),當下拉的時候才會看見視窗的背景色