1. 程式人生 > >微信小程式的檔案結構 —— 微信小程式教程系列(1)

微信小程式的檔案結構 —— 微信小程式教程系列(1)

檔案結構



示例目錄:HelloWorld


全域性檔案


app.js檔案

這個是小程式的指令碼程式碼檔案,可以在這個檔案上進行監聽,並處理小程式的一些生命週期(比如一些全域性變數)

在這個app.js檔案內,需要使用App()函式,來註冊程式



演示:

//app.js

App({

  onLaunch: function () {

//當小程式初始化完成時,會觸發onLaunch(全域性只觸發一次)

  },

  onShow: function () {

//當小程式啟動,或從後臺進入前臺顯示,會觸發onShow

  },

  onHide: function () {

//當小程式從前臺進入後臺,會觸發onHide

  },

  onError: function (msg) {

//當小程式發生指令碼錯誤,或者api呼叫失敗時,會觸發onError並帶上錯誤資訊

  },

  other:function(){

//全域性函式,可以被專案上的其他js檔案呼叫

  },

  globalData:{

//全域性物件

  },

})



app.json檔案

小程式的全域性配置檔案


pages

來指定小程式由哪些頁面組成

接受一個數組,每一項都是字串。每一項代表對應頁面的【路徑+檔名】資訊,陣列的第一項代表小程式的初始頁面。小程式中新增/減少頁面,都需要對pages陣列進行修改。

檔名不需要寫檔案字尾,因為框架會自動去尋找路徑.json,.js,.wxml,.wxss的四個檔案進行整合。

例如:

{

"pages":[

    "pages/index/index",

    "pages/logs/logs"

  ]

}

備註:pages內只需要寫wxml檔案的路徑,其他檔案不用寫

window

用於設定小程式的狀態列、導航條、標題、視窗背景色


示例:

{
  "window":{
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "微信介面功能演示",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
  }
}



tabBar

如果我們的小程式是一個多 tab應用(客戶端視窗的底部或頂部有 tab欄可以切換頁面),那麼我們可以通過 tabBar配置項指定 tab欄的表現,以及 tab切換時顯示的對應頁面。

Tip: 通過頁面跳轉(wx.navigateTo)或者頁面重定向(wx.redirectTo)所到達的頁面,即使它是定義在 tabBar配置中的頁面,也不會顯示底部的 tab欄。

tabBar 是一個數組,只能配置最少2個、最多5個 tab,tab按陣列的順序排序。



示例:

{

  "tabBar": {

"color":"#818181",

"selectedColor":"#0082D7",

"borderStyle":"white",

    "list": [{

      "pagePath": "pages/index/index",

      "text": "首頁",

      "iconPath":"images/tabbar/index@2x.png",

      "selectedIconPath":"images/tabbar/index[email protected]"

    }, {

      "pagePath": "pages/me/me",

      "text": "設定",

      "iconPath":"images/tabbar/me@2x.png",

      "selectedIconPath":"images/tabbar/me[email protected]"

    }]

  }

}

networkTimeout

可以設定各種網路請求的超時時間。


示例:

{

  "networkTimeout": {

    "request": 10000,

    "downloadFile": 10000

  }

}


debug

可以在開發者工具中開啟 debug模式,在開發者工具的控制檯面板,除錯資訊以 info的形式給出,其資訊有Page的註冊,頁面路由,資料更新,事件觸發 。 可以幫助開發者快速定位一些常見的問題。

示例:

{

  "debug": false

}

app.wxss檔案

定義全域性的樣式

基本上與css差不多,這裡不用多講

一個頁面的內部

xxx.js

邏輯主函式

Page({

})


示例:

//index.js

Page({

  data: {

    text: "This is page data."

  },

  onLoad: function(options) {

    // Do some initialize when page load.

  },

  onReady: function() {

    // Do something when page ready.

  },

  onShow: function() {

    // Do something when page show.

  },

  onHide: function() {

    // Do something when page hide.

  },

  onUnload: function() {

    // Do something when page close.

  },

  onPullDownRefresh: function() {

    // Do something when pull down.

  },

  onReachBottom: function() {

    // Do something when page reach bottom.

  },

  onShareAppMessage: function () {

   // return custom share data when user share.

  },

  // Event handler.

  viewTap: function() {

    this.setData({

      text: 'Set some data for updating view.'

    })

  },

  customData: {

    hi: 'MINA'

  }

})





示例:

Page({

  onShareAppMessage: function () {

    return {

      title: '自定義分享標題',

      desc: '自定義分享描述',

      path: '/page/user?id=123'

    }

  }

})


xxx.wxml

使用微信提供的元件來代替html元素


示例:


xxx.wxss

小程式樣式,與css樣式基本相似,這裡不重複論述

在當前頁面的wxss檔案內編輯的css樣式,只能使用在當前頁面


xxx.json

每一個小程式頁面也可以使用.json檔案來對本頁面的視窗表現進行配置。 頁面的配置比app.json全域性配置簡單得多,只是設定 app.json中的 window配置項的內容,頁面中配置項會覆蓋 app.json的 window中相同的配置項。

頁面的.json只能設定 window相關的配置項,以決定本頁面的視窗表現,所以無需寫 window這個鍵



示例:

{

  "navigationBarBackgroundColor": "#ffffff",

  "navigationBarTextStyle": "black",

  "navigationBarTitleText": "微信介面功能演示",

  "backgroundColor": "#eeeeee",

  "backgroundTextStyle": "light"

}


微信小程式教程系列

註冊上線篇

------------------------------------------------------------

基礎篇

------------------------------------------------------------

實戰篇

------------------------------------------------------------

電商篇

------------------------------------------------------------