微信小程序 Page（）函數詳解

2019-11-20 08:43:52

字體：大中小

來源：轉載

供稿：網友

微信小程序――Page（）:

在開發微信小程序的時候遇到函數，或者不明白的地方，最好上官網查詢，相應的知識，這里小編幫大家整理了下page()函數的用法。

Page() 函數用來注冊一個頁面。接受一個 object 參數，其指定頁面的初始數據、生命周期函數、事件處理函數等。

object 參數說明：

屬性	類型	描述
data	Object	頁面的初始數據
onLoad	Function	生命周期函數--監聽頁面加載
onReady	Function	生命周期函數--監聽頁面初次渲染完成
onShow	Function	生命周期函數--監聽頁面顯示
onHide	Function	生命周期函數--監聽頁面隱藏
onUnload	Function	生命周期函數--監聽頁面卸載
onPullDownRefreash	Function	頁面相關事件處理函數--監聽用戶下拉動作
其他	Any	開發者可以添加任意的函數或數據到 object 參數中，用 this 可以訪問

示例代碼：

//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  },  // Event handler.  viewTap: function() {   this.setData({    text: 'Set some data for updating view.'   })  } })

初始化數據

初始化數據將作為頁面的第一次渲染。data 將會以 JSON 的形式由邏輯層傳至渲染層，所以其數據必須是可以轉成 JSON 的格式：字符串，數字，布爾值，對象，數組。
渲染層可以通過 WXML 對數據進行綁定。

示例代碼：

<view>{{text}}</view> <view>{{array[0].msg}}</view>

Page({  data: {   text: 'init data',   array: [{msg: '1'}, {msg: '2'}]  } })

生命周期函數

onLoad: 頁面加載

一個頁面只會調用一次。

參數可以獲取wx.navigateTo和wx.redirectTo及<navigator/>中的 query。

onShow: 頁面顯示

每次打開頁面都會調用一次。

onReady: 頁面初次渲染完成

一個頁面只會調用一次，代表頁面已經準備妥當，可以和視圖層進行交互。

對界面的設置如wx.setNavigationBarTitle請在onReady之后設置。詳見生命周期

onHide: 頁面隱藏

當navigateTo或底部tab切換時調用。

onUnload: 頁面卸載

當redirectTo或navigateBack的時候調用。

頁面相關事件處理函數

onPullDownRefresh: 下拉刷新

監聽用戶下拉刷新事件。

需要在config的window選項中開啟enablePullDownRefresh。

當處理完數據刷新后，wx.stopPullDownRefresh可以停止當前頁面的下拉刷新。

事件處理函數

除了初始化數據和生命周期函數，Page 中還可以定義一些特殊的函數：事件處理函數。在渲染層可以在組件中加入事件綁定，當達到觸發事件時，就會執行 Page 中定義的事件處理函數。

示例代碼：

<view bindtap="viewTap"> click me </view>

Page({  viewTap: function() {   console.log('view tap')  } })

Page.prototype.setData()

setData 函數用于將數據從邏輯層發送到視圖層，同時改變對應的 this.data 的值。

注意：

直接修改 this.data 無效，無法改變頁面的狀態，還會造成數據不一致。
單次設置的數據不能超過1024kB，請盡量避免一次設置過多的數據。

setData() 參數格式

接受一個對象，以 key，value 的形式表示將 this.data 中的 key 對應的值改變成 value。
其中 key 可以非常靈活，以數據路徑的形式給出，如 array[2].message，a.b.c.d，并且不需要在 this.data 中預先定義。

示例代碼：

<view>{{text}}</view> <button bindtap="changeText"> Change normal data </button> <view>{{array[0].text}}</view> <button bindtap="changeItemInArray"> Change Array data </button> <view>{{obj.text}}</view> <button bindtap="changeItemInObject"> Change Object data </button> <view>{{newField.text}}</view> <button bindtap="addNewField"> Add new data </button>

//index.js Page({  data: {   text: 'init data',   array: [{text: 'init data'}],   object: {    text: 'init data'   }  },  changeText: function() {   // this.data.text = 'changed data' // bad, it can not work   this.setData({    text: 'changed data'   })  },  changeItemInArray: function() {   // you can use this way to modify a danamic data path   this.setData({    'array[0].text':'changed data'   })  },  changeItemInObject: function(){   this.setData({    'object.text': 'changed data'   });  },  addNewField: function() {   this.setData({    'newField.text': 'new data'   })  } })

以下內容你不需要立馬完全弄明白，不過以后它會有幫助。

生命周期

下圖說明了 Page 實例的生命周期。

頁面的路由

在小程序中所有頁面的路由全部由框架進行管理，對于路由的觸發方式以及頁面生命周期函數如下：
路由方式

觸發時機路由后頁面路由前頁面

觸發時機	路由后頁面	路由前頁面
初始化	小程序打開的第一個頁面	onLoad，onShow
打開新頁面	調用 API wx.navigateTo 或使用組件<navigator />	onLoad，onShow	onHide
頁面重定向	調用 API wx.redirectTo 或使用組件<navigator />	onLoad，onShow	onUnload
頁面返回	調用 API wx.navigateBack或用戶按左上角返回按鈕	onShow	onUnload
Tab切換	多 Tab 模式下用戶切換 Tab	第一次打開 onLoad，onshow；否則 onShow	onHide