注冊頁面

Page

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

object參數(shù)說明：

示例代碼：

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

初始化數(shù)據(jù)

初始化數(shù)據(jù)將作為頁面的第一次渲染。data將會以JSON的形式由邏輯層傳至渲染層，所以其數(shù)據(jù)必須是可以轉(zhuǎn)成JSON的格式：字符串，數(shù)字，布爾值，對象，數(shù)組。

渲染層可以通過WXML對數(shù)據(jù)進行綁定。

示例代碼：

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

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

事件處理函數(shù)

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

示例代碼：

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

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

Page.prototype.setData()

setData函數(shù)用于將數(shù)據(jù)從邏輯層發(fā)送到視圖層，同時改變對應(yīng)的this.data的值。

注意：

1. 直接修改this.data無效，無法改變頁面的狀態(tài)，還會造成數(shù)據(jù)不一致。
2. 單次設(shè)置的數(shù)據(jù)不能超過1024kB，請盡量避免一次設(shè)置過多的數(shù)據(jù)。

setData()參數(shù)格式

接受一個對象，以key，value的形式表示將this.data中的key對應(yīng)的值改變成value。

其中key可以非常靈活，以數(shù)據(jù)路徑的形式給出，如array[2].message，a.b.c.d，并且不需要在this.data中預(yù)先定義。

示例代碼：

<!--index.wxml-->
<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
    var changedData = {}
    var index = 0
    changedData['array[' + index + '].text'] = 'changed data'
    this.setData(changedData)
  },
  changeItemInObject: function(){
    this.setData({
      'object.text': 'changed data'
    });
  },
  addNewField: function() {
    this.setData({
      'newField.text': 'new data'
    })
  }
})

getCurrentPages()

getCurrentPages() 函數(shù)用于獲取當前頁面棧的實例，以數(shù)組形式按棧的順序給出，第一個元素為首頁，最后一個元素為當前頁面。

注意：不要嘗試修改頁面棧，會導(dǎo)致路由以及頁面狀態(tài)錯誤。

頁面棧

框架以棧的形式維護了當前的所有頁面。 當發(fā)生路由切換的時候，頁面棧的表現(xiàn)如下：

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

生命周期函數(shù)

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

頁面的路由

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

Tab 切換對應(yīng)的生命周期（以 A、B 頁面為 Tabbar 頁面，C 是從 A 頁面打開的頁面，D 頁面是從 C 頁面打開的頁面為例）：

Bug & Tip

1. bug: iOS/Android 6.3.30, 首次進入頁面，如果頁面不滿一屏?xí)r會觸發(fā) onReachBottom ，應(yīng)為只有用戶主動上拉才觸發(fā)；
2. bug: iOS/Android 6.3.30, 手指上拉，會觸發(fā)多次 onReachBottom ，應(yīng)為一次上拉，只觸發(fā)一次；