1. 程式人生 > 實用技巧 >uni-app入門(uni-app專案結構介紹、pages.json配置項列表)

uni-app入門(uni-app專案結構介紹、pages.json配置項列表)

一、uni-app專案結構

上一篇部落格咱們介紹瞭如何建立一個uni-app專案,專案建立完成後的目錄樣式如圖所示:

在這裡插入圖片描述

  1. pages 業務頁面檔案存放的目錄

pages裡面可以存放.vue的頁面,如下圖所示:index的頁面

在這裡插入圖片描述

  1. static 存放應用引用靜態資源(如圖片、視訊等)的目錄,注意:靜態資源只能存放於此
    在這裡插入圖片描述

  2. App.vue 應用配置,用來配置App全域性樣式以及監聽 應用生命週期

  3. main.js Vue初始化入口檔案

  4. manifest.json 配置應用名稱、appid、logo、版本等打包資訊
    在這裡插入圖片描述

  5. pages.json 配置頁面路由、導航條、選項卡等頁面類資訊
    在這裡插入圖片描述

二、pages.json配置項列表

下面只介紹幾個常用的屬性,如需其他熟悉可檢視uni-app的官方文件

屬性型別必填描述
pagesObject Array設定頁面路徑及視窗表現
globalStyleObject設定預設頁面的視窗表現
tabBarObject設定底部 tab 的表現
conditionObject啟動模式配置
  • globalStyle

用於設定應用的狀態列、導航條、標題、視窗背景色等。

屬性型別預設值描述
navigationBarBackgroundColorHexColor#F7F7F7導航欄背景顏色(同狀態列背景色)
navigationBarTextStyleStringwhite導航欄標題顏色及狀態列前景顏色,僅支援 black/white
navigationBarTitleTextString導航欄標題文字內容
navigationStyleStringdefault導航欄樣式,僅支援 default/custom。custom即取消預設的原生導航欄
backgroundColorHexColor#ffffff下拉顯示出來的視窗的背景色
backgroundTextStyleStringdark下拉 loading 的樣式,僅支援 dark / light
enablePullDownRefreshBooleanfalse是否開啟下拉重新整理
onReachBottomDistanceNumber50頁面上拉觸底事件觸發時距頁面底部距離,單位只支援px
  • pages

uni-app 通過 pages 節點配置應用由哪些頁面組成,pages 節點接收一個數組,陣列每個項都是一個物件,其屬性值如下:

屬性型別預設值描述
pathString配置頁面路徑
styleObject配置頁面視窗表現 (詳細檢視下面pages下style的屬性)

注意:

pages節點的第一項為應用入口頁(即首頁)
應用中新增/減少頁面,都需要對 pages 陣列進行修改
檔名不需要寫字尾,框架會自動尋找路徑下的頁面資源

在這裡插入圖片描述

  • pages下style的屬性:

用於設定每個頁面的狀態列、導航條、標題、視窗背景色等。
頁面中配置項會覆蓋 globalStyle 中相同的配置項

屬性型別預設值描述
navigationBarBackgroundColorHexColor#000000導航欄背景顏色(同狀態列背景色)
navigationBarTextStyleStringwhite導航欄標題顏色及狀態列前景顏色,僅支援 black/white
navigationBarTitleTextString導航欄標題文字內容
navigationBarShadowObject導航欄陰影
navigationStyleStringdefault導航欄樣式,僅支援 default/custom。custom即取消預設的原生導航欄
backgroundColorHexColor#ffffff視窗的背景色
backgroundTextStyleStringdark下拉 loading 的樣式,僅支援 dark/light
enablePullDownRefreshBooleanfalse是否開啟下拉重新整理
onReachBottomDistanceNumber50頁面上拉觸底事件觸發時距頁面底部距離,單位只支援px

注意:視窗的背景色backgroundColor,只有在開啟下拉重新整理時(enablePullDownRefresh:true),當下拉的時候才會看見視窗的背景色