小程式進階(三)----------- 頁面配置 page.json
阿新 • • 發佈:2018-12-24
頁面配置 page.json
這裡的 page.json
其實用來表示 pages/logs 目錄下的 logs.json
這類和小程式頁面相關的配置。
如果你整個小程式的風格是藍色調,那麼你可以在 app.json
裡邊宣告頂部顏色是藍色即可。實際情況可能不是這樣,可能你小程式裡邊的每個頁面都有不一樣的色調來區分不同功能模組,因此我們提供了 page.json
,讓開發者可以獨立定義每個頁面的一些屬性,例如剛剛說的頂部顏色、是否允許下拉重新整理等等。
每一個小程式頁面也可以使用.json
檔案來對本頁面的視窗表現進行配置。
頁面的配置只能設定 app.json
中部分 window
配置項的內容,頁面中配置項會覆蓋 app.json
的 window
中相同的配置項
配置示例
{ "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "navigationBarTitleText": "微信介面功能演示", "backgroundColor": "#eeeeee", "backgroundTextStyle": "light" }
頁面配置項列表
屬性 | 型別 | 預設值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 導航欄背景顏色,如 #000000 |
navigationBarTextStyle | String | white | 導航欄標題顏色,僅支援 black / white |
navigationBarTitleText | String | 導航欄標題文字內容 | |
backgroundColor | HexColor | #ffffff | 視窗的背景色 |
backgroundTextStyle | String | dark | 下拉 loading 的樣式,僅支援 dark / light |
enablePullDownRefresh | Boolean | false | 是否全域性開啟下拉重新整理。 詳見 下面 |
onReachBottomDistance | Number | 50 | 頁面上拉觸底事件觸發時距頁面底部距離,單位為px。 詳見 下面說明 |
disableScroll | Boolean | false | 設定為 true 則頁面整體不能上下滾動;只在頁面配置中有效,無法在 app.json 中設定該項 |
當中兩個頁面事件處理函式:
onPullDownRefresh()
監聽使用者下拉重新整理事件。
- 需要在
app.json
的window選項中或頁面配置中開啟enablePullDownRefresh
。 - 可以通過wx.startPullDownRefresh觸發下拉重新整理,呼叫後觸發下拉重新整理動畫,效果與使用者手動下拉重新整理一致。
- 當處理完資料重新整理後,wx.stopPullDownRefresh可以停止當前頁面的下拉重新整理
onReachBottom()
監聽使用者上拉觸底事件。
- 可以在
app.json
的window選項中或頁面配置中設定觸發距離onReachBottomDistance
。 - 在觸發距離內滑動期間,本事件只會被觸發一次。
在這當中我們來介紹一下:window
window
用於設定小程式的狀態列、導航條、標題、視窗背景色。
屬性 | 型別 | 預設值 | 描述 | 最低版本 |
---|---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 導航欄背景顏色,如 #000000 |
|
navigationBarTextStyle | String | white | 導航欄標題顏色,僅支援 black / white |
|
navigationBarTitleText | String | 導航欄標題文字內容 | ||
navigationStyle | String | default | 導航欄樣式,僅支援以下值:default 預設樣式custom 自定義導航欄,只保留右上角膠囊按鈕 |
微信版本 6.6.0 |
backgroundColor | HexColor | #ffffff | 視窗的背景色 | |
backgroundTextStyle | String | dark | 下拉 loading 的樣式,僅支援 dark / light |
|
backgroundColorTop | String | #ffffff | 頂部視窗的背景色,僅 iOS 支援 | 微信版本 6.5.16 |
backgroundColorBottom | String | #ffffff | 底部視窗的背景色,僅 iOS 支援 | 微信版本 6.5.16 |
注:navigationStyle
只在 app.json
中生效。
頁面的
.json
只能設定window
相關的配置項,以決定本頁面的視窗表現,所以無需寫window
這個鍵。