我的微信小程序第三篇(app.json)


前言

端午節回家了,所以好多天沒有更新,只想說還是待在家里舒服呀,媽媽各種做好吃的,小侄子侄女各種粘着我在室外玩,導致我三天下來不僅胖了一圈,還黑了一圈,上班第一天有同事就說我曬黑了,哭~~~,為了防止自己的"懶癌"症復發,趕緊打開電腦敲敲字,廢話不多說,我們就回到今天的主題,今天給大家介紹下微信小程序框架主體文件中的配置文件(app.json),其實我們在上一篇《我的微信小程序第二篇》中已經對app.json做過簡單的描述,在此篇中,我們將對其進行詳細的介紹。

 

正文

app.json是小程序的全局配置文件,編寫時需嚴格遵循json的格式規范,app.json在程序加載時加載,負責全局配置,其配置項有:

  • pages:設置頁面路徑,必填

  • window:設置默認頁面的窗口表現

  • tabBar:設置tab的表現

  • networkTimeOut:設置網絡超時時間

  • debug:設置是否開啟debug模式,默認關閉false

app.json文件內容整體結構如下;

  1. pages配置

    pages負責注冊小程序頁面,必須填寫,值為一個包含頁面路徑的數組,用來指定小程序由哪些頁面構成,如下所示:

      //頁面路徑設置

      "pages":[

        "pages/index/index",

        "pages/logs/logs"

      ]

    pages中不需要填寫文件后綴名,渲染頁面時框架會自動尋找路徑.json,.js,.wxml,.wxss四個文件進行整合,建議文件名和目錄名保持一致,便於管理,pages配置中第一項代表小程序的初始頁面,小程序增加或者修改,刪除頁面都需要對pages進行相應的調整。

2.window配置

Window負責小程序狀態欄,導航條,標題,窗口背景色等系統級樣式。屬性有:

  • navigationBarBackgroundColor:導航欄背景色,默認值為#fff

  • navigationBarTextStyle:導航欄標題顏色,僅支持black/white,默認值為black

  • navigationBarTitleText:導航欄標題文字內容

  • backgroundTextStyle:下拉背景字體,loading圖樣式,僅支持dark/light

  • backgroundColor:窗口背景色,默認值為#ffffff

  • enablePullDownRefresh:是否開啟下拉刷新,默認為false,開啟后,當用戶下拉時會觸發頁面onPullDownRefresh事件

     

3.TabBar配置

當程序頂部或者底部需要菜單欄時,我們可以通過tabbar設置,非必填,屬性如下:

  • color:tab上文字默認顏色,默認值為#000000

  • selectedColor:tab上文字選中時的顏色,默認值為#000000

  • backgroundColor:tab背景色

  • borderStyle:tabbar上邊框顏色,僅支持black\white,默認值為black

  • list:tab的列表,必填項,其值為一個數組,最少2個,最多5個,數組中每一個項是一個對象,代表一個tab的相關配置,配置如下:

 

  • pagepath:頁面路徑,必須在pages中先定義,必填項

  • text:tab上按鈕的文字

  • iconpath:tab上icon的相對路徑,icon大小限制在40kb

  • selectedIconPath:選中圖片的相對路徑,,icon大小限制在40kb

  • position:在頂部或者底部顯示,可選值為bottom/top,默認值為bottom

    4.networkTimeout配置

    小程序中各種請求API的超時時間只能通過networktimeout統一設置,不能在api中單獨設置,屬性如下:

  • request:設置wx.request的超時時間,單位毫秒

  • connectSocket:設置wx.connectSocket的超時時間,單位毫秒

  • uploadFile:設置wx.uploadFile的超時時間,單位毫秒

  • downloadFile:設置wx.downloadFile的超時時間,單位為毫秒

    5.debug配置

  • 此配置項控制是否開啟debug模式,默認是關閉的,當開啟debug模式時,在開發者工具面板,調試信息以info形式輸出,有page注冊,頁面路由,數據更新,事件觸發,可以幫助開發者快速定位一些問題。

相關推薦:《微信小程序開發入門及案例詳解》---李駿

歡迎關注我的個人微信公眾號

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM