微信小程式 Page()函數詳解

黄舟
發布: 2017-01-16 15:32:11
原創
2661 人瀏覽過

微信小程式――Page():

在開發微信小程式的時候遇到函數,或是不懂的地方,最好上官網查詢,對應的知識,這裡小編幫大家整理了一下page()函數的用法。

Page() 函數用來註冊一個頁面。接受一個 object 參數,其指定頁面的初始資料、生命週期函數、事件處理函數等。

object 參數說明:

屬性      類型          描述

data    載入   

onReady    Function    生命週期函數--監聽頁面初次渲染完成   

onShow Function    生命週期函數--監聽頁顯示   

onHide    Function    生命週期函數--監聽頁隱藏   

onUnload   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: &#39;init data&#39;,   
  array: [{msg: &#39;1&#39;}, {msg: &#39;2&#39;}]   
 }   
})
登入後複製

生命週期函數

onLoad: 頁面載入

一個頁面只會呼叫一次。

參數可以取得wx.navigateTo和wx.redirectTo及中的 query。

onShow: 頁面顯示

每次開啟頁面都會呼叫一次。

onReady: 頁面初次渲染完成

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

對介面的設定如wx.setNavigationBarTitle請在onReady之後設定。詳見生命週期

onHide: 頁面隱藏

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

onUnload: 頁面卸載

當redirectTo或navigateBack的時候呼叫。

頁面相關事件處理函數

onPullDownRefresh: 下拉刷新

監聽用戶下拉刷新事件。

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

當處理完資料刷新後,wx.stopPullDownRefresh可以停止目前頁面的下拉刷新。

事件處理函數

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

範例程式碼:

click me  

Page({   
 viewTap: function() {   
  console.log(&#39;view tap&#39;)   
 }   
})
登入後複製

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: &#39;init data&#39;,   
  array: [{text: &#39;init data&#39;}],   
  object: {   
   text: &#39;init data&#39;   
  }   
 },   
 changeText: function() {   
  // this.data.text = &#39;changed data&#39; // bad, it can not work   
  this.setData({   
   text: &#39;changed data&#39;   
  })   
 },   
 changeItemInArray: function() {   
  // you can use this way to modify a danamic data path   
  this.setData({   
   &#39;array[0].text&#39;:&#39;changed data&#39;   
  })   
 },   
 changeItemInObject: function(){   
  this.setData({   
   &#39;object.text&#39;: &#39;changed data&#39;   
  });   
 },   
 addNewField: function() {   
  this.setData({   
   &#39;newField.text&#39;: &#39;new data&#39;   
  })   
 }   
})
登入後複製

以下內容你不需要立刻完全弄清楚,不過以後它會有幫助。

生命週期

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



頁面的路由

微信小程式 Page()函數詳解

在小程式中所有頁面的路由全部由框架進行管理,對於路由的觸發方式以及頁面生命週期函數如下:


路由方式

時機路由後頁路由前觸發時機頁





觸發時機                                     路由前頁

初始化   小程式開啟的第一頁                onLoad,onShow    

開啟新頁面   呼叫API wx.navigateTo 或使用元件    onLoad,onShow    onHide    

頁重定向  

頁面回傳   呼叫API wx.navigateBack或用戶按左上角返回按鈕   onShow    onUnload    

Tab切換   多Tab 模式下用戶切換Tab    第一次開啟onLoad,onshow;否則onShowo🎠  onHo信相關內容請關注PHP中文網(www.php.cn)!

相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板
關於我們 免責聲明 Sitemap
PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!