Page

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

object 參數(shù)說明：

object 內(nèi)容在頁面加載時會進(jìn)行一次深拷貝，需考慮數(shù)據(jù)大小對頁面加載的開銷

示例代碼：

//index.jsPage({
  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.
  },
  onPageScroll: function() {    // Do something when page scroll
  },
  onTabItemTap(item) {    console.log(item.index)    console.log(item.pagePath)    console.log(item.text)
  },  // Event handler.
  viewTap: function() {    this.setData({
      text: 'Set some data for updating view.'
    }, function() {      // this is setData callback
    })
  },
  customData: {
    hi: 'MINA'
  }
})

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

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

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

示例代碼：

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

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

生命周期函數(shù)

• onLoad: 頁面加載

• 一個頁面只會調(diào)用一次，可以在 onLoad 中獲取打開當(dāng)前頁面所調(diào)用的 query 參數(shù)。

• onShow: 頁面顯示

• 每次打開頁面都會調(diào)用一次。

• onReady: 頁面初次渲染完成

• 一個頁面只會調(diào)用一次，代表頁面已經(jīng)準(zhǔn)備妥當(dāng)，可以和視圖層進(jìn)行交互。

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

• onHide: 頁面隱藏

• 當(dāng)navigateTo或底部tab切換時調(diào)用。

• onUnload: 頁面卸載

• 當(dāng)redirectTo或navigateBack的時候調(diào)用。

生命周期的調(diào)用以及頁面的路由方式詳見

onLoad參數(shù)

頁面相關(guān)事件處理函數(shù)

• onPullDownRefresh: 下拉刷新

• 監(jiān)聽用戶下拉刷新事件。

• 需要在app.json的window選項中或頁面配置中開啟enablePullDownRefresh。

• 當(dāng)處理完數(shù)據(jù)刷新后，wx.stopPullDownRefresh可以停止當(dāng)前頁面的下拉刷新。

• onReachBottom: 上拉觸底

• 監(jiān)聽用戶上拉觸底事件。

• 可以在app.json的window選項中或頁面配置中設(shè)置觸發(fā)距離onReachBottomDistance。

• 在觸發(fā)距離內(nèi)滑動期間，本事件只會被觸發(fā)一次。

• onPageScroll: 頁面滾動

• 監(jiān)聽用戶滑動頁面事件。

• 參數(shù)為 Object，包含以下字段：

• onShareAppMessage: 用戶轉(zhuǎn)發(fā)

• 只有定義了此事件處理函數(shù)，右上角菜單才會顯示“轉(zhuǎn)發(fā)”按鈕

• 用戶點(diǎn)擊轉(zhuǎn)發(fā)按鈕的時候會調(diào)用

• 此事件需要 return 一個 Object，用于自定義轉(zhuǎn)發(fā)內(nèi)容

自定義轉(zhuǎn)發(fā)字段

示例代碼

Page({
  onShareAppMessage: function () {    return {
      title: '自定義轉(zhuǎn)發(fā)標(biāo)題',
      path: '/page/user?id=123'
    }
  }
})

事件處理函數(shù)

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

示例代碼：

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

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

Page.prototype.route

基礎(chǔ)庫 1.2.0 開始支持，低版本需做兼容處理

route 字段可以獲取到當(dāng)前頁面的路徑。

Page.prototype.setData()

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

setData() 參數(shù)格式

object 以 key，value 的形式表示將 this.data 中的 key 對應(yīng)的值改變成 value。 callback 是一個回調(diào)函數(shù)，在這次setData對界面渲染完畢后調(diào)用。

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

注意：

1. 直接修改 this.data 而不調(diào)用 this.setData 是無法改變頁面的狀態(tài)的，還會造成數(shù)據(jù)不一致。

2. 單次設(shè)置的數(shù)據(jù)不能超過1024kB，請盡量避免一次設(shè)置過多的數(shù)據(jù)。

3. 請不要把 data 中任何一項的 value 設(shè)為 undefined ，否則這一項將不被設(shè)置并可能遺留一些潛在問題。

示例代碼：

<!--index.wxml--><view>{{text}}</view><button bindtap="changeText"> Change normal data </button><view>{{num}}</view><button bindtap="changeNum"> Change normal num </button><view>{{array[0].text}}</view><button bindtap="changeItemInArray"> Change Array data </button><view>{{object.text}}</view><button bindtap="changeItemInObject"> Change Object data </button><view>{{newField.text}}</view><button bindtap="addNewField"> Add new data </button>

//index.jsPage({
  data: {
    text: 'init data',
    num: 0,
    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'
    })
  },
  changeNum: function() {    this.data.num = 1
    this.setData({
      num: this.data.num
    })
  },
  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'
    })
  }
})

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

生命周期

下圖說明了 Page 實(shí)例的生命周期。