pages.json 頁面路由
pages.json
?文件用來對 uni-app 進行全局配置,決定頁面文件的路徑、窗口樣式、原生的導航欄、底部的原生tabbar 等。
導航欄高度為 44px (不含狀態欄),tabBar 高度為 50px (不含安全區)。
它類似微信小程序中app.json
的頁面管理部分。注意定位權限申請等原屬于app.json
的內容,在uni-app中是在manifest中配置。
page.json配置項列表
屬性 | 類型 | 必填 | 描述 | 平臺兼容 |
---|---|---|---|---|
globalStyle | Object | 否 | 設置默認頁面的窗口表現 | |
pages | Object Array | 是 | 設置頁面路徑及窗口表現 | |
easycom | Object | 否 | 組件自動引入規則 | 2.5.5+ |
tabBar | Object | 否 | 設置底部 tab 的表現 | |
condition | Object | 否 | 啟動模式配置 | |
subPackages | Object Array | 否 | 分包加載配置 | H5 不支持 |
preloadRule | Object | 否 | 分包預下載規則 | 微信小程序 |
workers | String | 否 | Worker ?代碼放置的目錄 | 微信小程序 |
leftWindow | Object | 否 | 大屏左側窗口 | H5 |
topWindow | Object | 否 | 大屏頂部窗口 | H5 |
rightWindow | Object | 否 | 大屏右側窗口 | H5 |
uniIdRouter | Object | 否 | 自動跳轉相關配置,新增于HBuilderX 3.5.0 | |
entryPagePath | String | 否 | 默認啟動首頁,新增于HBuilderX 3.7.0 | 微信小程序、支付寶小程序 |
本篇先來學習?globalStyle
globalStyle用于設置應用的狀態欄、導航條、標題、窗口背景色等。下面介紹下它幾個常用的屬性配置(PS:不同的小程序,配置屬性會略有差異,詳情請查看官方文檔):
1.navigationBarTextStyle:導航欄標題顏色及狀態欄前景顏色,僅支持 black/white,默認為black;?
2.navigationBarTitleText:導航欄標題文字內容;?
3.navigationBarBackgroundColor:導航欄背景顏色(同狀態欄背景色);?
4.backgroundColor:下拉顯示出來的窗口的背景色;?
5.backgroundTextStyle:下拉 loading 的樣式,僅支持 dark / light;
6.enablePullDownRefresh:是否開啟下拉刷新;
7.onReachBottomDistance:頁面上拉觸底事件觸發時距頁面底部距離,單位只支持px。
頁面上拉觸底事件的使用:
<script setup>import {onReachBottom} from "@dcloudio/uni-app"onReachBottom(()=>{console.log("觸底加載...")})
</script>
更多信息,?官方文檔詳見pages.json 頁面路由 | uni-app官網