微信小程序 Page()函數(shù)詳解
微信小程序——Page():
在開(kāi)發(fā)微信小程序的時(shí)候遇到函數(shù),或者不明白的地方,最好上官網(wǎng)查詢,相應(yīng)的知識(shí),這里小編幫大家整理了下page()函數(shù)的用法。
Page() 函數(shù)用來(lái)注冊(cè)一個(gè)頁(yè)面。接受一個(gè) object 參數(shù),其指定頁(yè)面的初始數(shù)據(jù)、生命周期函數(shù)、事件處理函數(shù)等。
object 參數(shù)說(shuō)明:
屬性 | 類型 | 描述 |
---|---|---|
data | Object | 頁(yè)面的初始數(shù)據(jù) |
onLoad | Function | 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面加載 |
onReady | Function | 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面初次渲染完成 |
onShow | Function | 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面顯示 |
onHide | Function | 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面隱藏 |
onUnload | Function | 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面卸載 |
onPullDownRefreash | Function | 頁(yè)面相關(guān)事件處理函數(shù)--監(jiān)聽(tīng)用戶下拉動(dòng)作 |
其他 | Any | 開(kāi)發(fā)者可以添加任意的函數(shù)或數(shù)據(jù)到 object 參數(shù)中,用 this 可以訪問(wèn) |
示例代碼:
//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.' }) } })
初始化數(shù)據(jù)
初始化數(shù)據(jù)將作為頁(yè)面的第一次渲染。data 將會(huì)以 JSON 的形式由邏輯層傳至渲染層,所以其數(shù)據(jù)必須是可以轉(zhuǎn)成 JSON 的格式:字符串,數(shù)字,布爾值,對(duì)象,數(shù)組。
渲染層可以通過(guò) WXML 對(duì)數(shù)據(jù)進(jìn)行綁定。
示例代碼:
<view>{{text}}</view> <view>{{array[0].msg}}</view>
Page({ data: { text: 'init data', array: [{msg: '1'}, {msg: '2'}] } })
生命周期函數(shù)
onLoad: 頁(yè)面加載
一個(gè)頁(yè)面只會(huì)調(diào)用一次。
參數(shù)可以獲取wx.navigateTo和wx.redirectTo及<navigator/>中的 query。
onShow: 頁(yè)面顯示
每次打開(kāi)頁(yè)面都會(huì)調(diào)用一次。
onReady: 頁(yè)面初次渲染完成
一個(gè)頁(yè)面只會(huì)調(diào)用一次,代表頁(yè)面已經(jīng)準(zhǔn)備妥當(dāng),可以和視圖層進(jìn)行交互。
對(duì)界面的設(shè)置如wx.setNavigationBarTitle請(qǐng)?jiān)趏nReady之后設(shè)置。詳見(jiàn)生命周期
onHide: 頁(yè)面隱藏
當(dāng)navigateTo或底部tab切換時(shí)調(diào)用。
onUnload: 頁(yè)面卸載
當(dāng)redirectTo或navigateBack的時(shí)候調(diào)用。
頁(yè)面相關(guān)事件處理函數(shù)
onPullDownRefresh: 下拉刷新
監(jiān)聽(tīng)用戶下拉刷新事件。
需要在config的window選項(xiàng)中開(kāi)啟enablePullDownRefresh。
當(dāng)處理完數(shù)據(jù)刷新后,wx.stopPullDownRefresh可以停止當(dāng)前頁(yè)面的下拉刷新。
事件處理函數(shù)
除了初始化數(shù)據(jù)和生命周期函數(shù),Page 中還可以定義一些特殊的函數(shù):事件處理函數(shù)。在渲染層可以在組件中加入事件綁定,當(dāng)達(dá)到觸發(fā)事件時(shí),就會(huì)執(zhí)行 Page 中定義的事件處理函數(shù)。
示例代碼:
<view bindtap="viewTap"> click me </view>
Page({ viewTap: function() { console.log('view tap') } })
Page.prototype.setData()
setData 函數(shù)用于將數(shù)據(jù)從邏輯層發(fā)送到視圖層,同時(shí)改變對(duì)應(yīng)的 this.data 的值。
注意:
直接修改 this.data 無(wú)效,無(wú)法改變頁(yè)面的狀態(tài),還會(huì)造成數(shù)據(jù)不一致。
單次設(shè)置的數(shù)據(jù)不能超過(guò)1024kB,請(qǐng)盡量避免一次設(shè)置過(guò)多的數(shù)據(jù)。
setData() 參數(shù)格式
接受一個(gè)對(duì)象,以 key,value 的形式表示將 this.data 中的 key 對(duì)應(yīng)的值改變成 value。
其中 key 可以非常靈活,以數(shù)據(jù)路徑的形式給出,如 array[2].message,a.b.c.d,并且不需要在 this.data 中預(yù)先定義。
示例代碼:
<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' }) } })
以下內(nèi)容你不需要立馬完全弄明白,不過(guò)以后它會(huì)有幫助。
生命周期
下圖說(shuō)明了 Page 實(shí)例的生命周期。
頁(yè)面的路由
在小程序中所有頁(yè)面的路由全部由框架進(jìn)行管理,對(duì)于路由的觸發(fā)方式以及頁(yè)面生命周期函數(shù)如下:
路由方式
觸發(fā)時(shí)機(jī) 路由后頁(yè)面 路由前頁(yè)面
觸發(fā)時(shí)機(jī) |
路由后頁(yè)面 | 路由前頁(yè)面 | |
---|---|---|---|
初始化 | 小程序打開(kāi)的第一個(gè)頁(yè)面 | onLoad,onShow | |
打開(kāi)新頁(yè)面 | 調(diào)用 API wx.navigateTo 或使用組件<navigator /> | onLoad,onShow | onHide |
頁(yè)面重定向 | 調(diào)用 API wx.redirectTo 或使用組件<navigator /> | onLoad,onShow | onUnload |
頁(yè)面返回 | 調(diào)用 API wx.navigateBack或用戶按左上角返回按鈕 | onShow | onUnload |
Tab切換 | 多 Tab 模式下用戶切換 Tab | 第一次打開(kāi) onLoad,onshow;否則 onShow | onHide |
感謝閱讀,希望能幫助到大家,謝謝大家對(duì)本站的支持!
- 微信小程序云函數(shù)使用mysql數(shù)據(jù)庫(kù)過(guò)程詳解
- 小程序云開(kāi)發(fā)教程如何使用云函數(shù)實(shí)現(xiàn)點(diǎn)贊功能
- 小程序云函數(shù)調(diào)用API接口的方法
- 微信小程序Page中data數(shù)據(jù)操作和函數(shù)調(diào)用方法
- 微信小程序提取公用函數(shù)到util.js及使用方法示例
- 微信小程序 功能函數(shù)小結(jié)(手機(jī)號(hào)驗(yàn)證*、密碼驗(yàn)證*、獲取驗(yàn)證碼*)
- 微信小程序 定義全局?jǐn)?shù)據(jù)、函數(shù)復(fù)用、模版等詳細(xì)介紹
- 微信小程序 函數(shù)防抖 解決重復(fù)點(diǎn)擊消耗性能問(wèn)題實(shí)現(xiàn)代碼
相關(guān)文章
微信小程序聯(lián)網(wǎng)請(qǐng)求的輪播圖
這篇文章主要介紹了微信小程序聯(lián)網(wǎng)請(qǐng)求的輪播圖的相關(guān)資料,需要的朋友可以參考下2017-07-07一篇文章學(xué)會(huì)jsBridge的運(yùn)行機(jī)制
JSBridge是一座用JavaScript搭建起來(lái)的橋,搭建這座橋的目的也很簡(jiǎn)單,讓native可以調(diào)用web的js代碼,讓web可以 “調(diào)用” 原生的代碼。本文主要通過(guò)分析源碼講解jsBridge的運(yùn)行機(jī)制,感興趣的朋友一起來(lái)看看吧2021-09-09微信小程序 基礎(chǔ)知識(shí)css樣式media標(biāo)簽
這篇文章主要介紹了微信小程序 基礎(chǔ)知識(shí)css樣式media標(biāo)簽的相關(guān)資料,需要的朋友可以參考下2017-02-02實(shí)現(xiàn)微信小程序的wxml文件和wxss文件在webstrom的支持
這篇文章主要介紹了實(shí)現(xiàn)微信小程序的wxml文件和wxss文件在webstrom的支持的相關(guān)資料,需要的朋友可以參考下2017-06-06