1. 程式人生 > >小程式進階(三)----------- 頁面配置 page.json

小程式進階(三)----------- 頁面配置 page.json

頁面配置 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.jsonwindow選項中或頁面配置中開啟enablePullDownRefresh
  • 可以通過wx.startPullDownRefresh觸發下拉重新整理,呼叫後觸發下拉重新整理動畫,效果與使用者手動下拉重新整理一致。
  • 當處理完資料重新整理後,wx.stopPullDownRefresh可以停止當前頁面的下拉重新整理

onReachBottom()

監聽使用者上拉觸底事件。

  • 可以在app.jsonwindow選項中或頁面配置中設定觸發距離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 這個鍵。