本篇主要介绍了微信小程序中的三个重要的函数app()getapp()page(),以及页面的初始化,数据模块化功能。
app()
app()函数用来注册一个小程序。接受一个object参数,其指定小程序的生命周期函数等。
object参数说明:
属性 类型 描述 触发时机
onlaunch function 生命周期函数--监听小程序初始化 当小程序初始化完成时,会触发onlaunch(全局只触发一次)
onshow function 生命周期函数--监听小程序显示 当小程序启动,或从后台进入前台显示,会触发onshow
onhide function 生命周期函数--监听小程序隐藏 当小程序从前台进入后台,会触发onhide
其他 any 开发者可以添加任意的函数或数据到object参数中,用this可以访问
前台、后台定义: 当用户点击左上角关闭,或者按了设备home键离开微信,小程序并没有正在的销毁,而是进入了后台;当再次启动微信或再次打开小程序,又会从后台进入前台。
只有当小程序进入后台一定时间,或者系统资源占用过高,才会被真正的销毁。
//app.js
app({
onlaunch: function () {
//调用api从本地缓存中获取数据
var logs = wx.getstoragesync('logs') || []
logs.unshift(date.now())
wx.setstoragesync('logs', logs)
},
getuserinfo:function(cb){
var that = this;
if(this.globaldata.userinfo){
typeof cb == "function" && cb(this.globaldata.userinfo)
}else{
//调用登录接口
wx.login({
success: function () {
wx.getuserinfo({
success: function (res) {
that.globaldata.userinfo = res.userinfo;
typeof cb == "function" && cb(that.globaldata.userinfo)
}
})
}
});
}
},
globaldata:{
userinfo:null,
ceshi:"i am global data"
}
})
复制代码
getapp()
我们提供了全局的getapp()函数,可以获取到小程序实例。
// other.js
var appinstance = getapp()
console.log(appinstance.globaldata) // i am global data
复制代码
注意:
app()必须在app.js中注册,且不能注册多个。
不要在定义于app()内的函数中调用getapp(),使用this就可以拿到app实例。
不要在onlaunch的时候调用getcurrentpage(),此时page还没有生成。
通过getapp获取实例之后,不要私自调用生命周期函数。
page
page()函数用来注册一个页面。接受一个object参数,其指定页面的初始数据、生命周期函数、事件处理函数等。
object参数说明:
属性 类型 描述
data object 页面的初始数据
onload function 生命周期函数--监听页面加载
onready function 生命周期函数--监听页面渲染完成
onshow function 生命周期函数--监听页面显示
onhide function 生命周期函数--监听页面隐藏
onunload function 生命周期函数--监听页面卸载
其他 any 开发者可以添加任意的函数或数据到object参数中,用this可以访问
初始化数据
初始化数据将作为页面的第一次渲染。data将会以json的形式由逻辑层传至渲染层,所以其数据必须是可以转成json的格式:字符串,数字,布尔值,对象,数组。
渲染层可以通过wxml对数据进行绑定。
示例代码:
<view>{{text}}</view>
<view>{{array[0].msg}}</view>
page({
data: {
text: 'init data',
array: [{msg: '1'}, {msg: '2'}]
}
})
复制代码
事件处理函数
除了初始化数据和生命周期函数,page中还可以定义一些特殊的函数:事件处理函数。在渲染层可以在组件中加入事件绑定,当达到触发事件时,就会执行page中定义的事件处理函数。
示例代码:
<view bindtap="viewtap"> click me </view>
page({
viewtap: function() {
console.log('view tap')
}
})
复制代码
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中预先定义。
示例代码:
<!--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'
})
}
})
复制代码
模块化
我们可以将一些公共的代码抽离成为一个单独的js文件,作为一个模块。模块只有通过module.exports才能对外暴露接口。
// common.js
function sayhello(name) {
console.log('hello ' + name + '!')
}
module.exports = {
sayhello: sayhello
}
复制代码
在需要使用这些模块的文件中,使用require(path)将公共代码引入。
var common = require('common.js')
page({
hellomina: function() {
common.sayhello('mina')
}
})
复制代码下一篇我们会介绍视图层的wxml。
更多微信小程序之代码解析:二.逻辑层 。