})
页面
Page() 函数用来注册一个页面。接受一个 object 参数,其指定页面的初始数据、生命周期函数、事件处理函数等。
data | 页面的初始数据,data 将会以 JSON 的形式由逻辑层传至渲染层, 所以其数据必须是可以转成 JSON 的格式:字符串,数字,布尔值, 对象,数组。 |
onLoad | 生命周期函数--监听页面加载,只会调用一次, 可以在 onLoad 中获取打开当前页面所调用的 query 参数 |
onReady | 生命周期函数--监听页面初次渲染完成 |
onShow | 生命周期函数--监听页面显示 |
onHide | 生命周期函数--监听页面隐藏 |
onUnload | 生命周期函数--监听页面卸载 |
onPullDownRefresh | 页面相关事件处理函数--监听用户下拉动作,下拉刷新 |
onReachBottom | 页面上拉触底事件的处理函数 |
onShareAppMessage | 用户点击右上角转发,点击转发按钮的时候会调用 此事件需要 return 一个 Object,用于自定义转发内容 |
onPageScroll | 页面滚动触发事件的处理函数 |
其他 | 开发者可以添加任意的函数或数据到 object 参数(data)中, 在页面的函数中用 this 可以访问 |
对界面的设置如wx.setNavigationBarTitle请在onReady之后设置
如
...
onPageScroll: function() { // Do something when page scroll }, // Event handler. viewTap: function() { this.setData({ text: 'Set some data for updating view.' }, function() { // this is setData callback }) }, customData: { hi: 'MINA' }
除了初始化数据和生命周期函数,Page 中还可以定义一些特殊的函数:事件处理函数。
<view bindtap="viewTap"> click me </view>
Page({ viewTap: function() { console.log('view tap') } })
setData 函数用于将数据从逻辑层发送到视图层(异步),同时改变对应的 this.data 的值(同步)。
- 直接修改 this.data 而不调用 this.setData 是无法改变页面的状态的,还会造成数据不一致。
模块化
可以将一些公共的代码抽离成为一个单独的 js 文件,作为一个模块。模块只有通过 module.exports 或者 exports 才能对外暴露接口。
推荐开发者采用 module.exports 来暴露模块接口
// common.js function sayHello(name) { console.log(`Hello ${name} !`) } function sayGoodbye(name) { console.log(`Goodbye ${name} !`) } module.exports.sayHello = sayHello exports.sayGoodbye = sayGoodbye
使用
var common = require('common.js') Page({ helloMINA: function() { common.sayHello('MINA') }, goodbyeMINA: function() { common.sayGoodbye('MINA') } })
require 暂时不支持绝对路径