小程序中一个框架页面包含4个文件,同一框架页面的这4个文件必须具有相同的路径与文件名,进入小程序时或页面跳转时,小程序会根据app.json配置的路径找到对应的资源进行渲染。
与框架主体文件相比框架页面文件多了一种页面结构文件,其余3个文件和框架主体文件的功能类同,下面我们一一讲解每个文件作用。
我们首先讲解页面配置文件,页面配置文件和框架配置文件一样,是一个json文件,与框架配置文件不同的时,页面配置文件是非必要存在的,同时页面配置文件的配置项只有window,控制当前页面的窗口表现,window的属性和app.json一致。渲染页面时,页面中的window配置项会覆盖app.json中的相同配置项。
由于页面的.json只能配置widow相关属性,编写时只需直接写出属性,不用写window这个键,如下所示:
{
"usingComponents": {},
"navigationBarBackgroundColor": "#000000",
"navigationBarTextStyle": "white",
"navigationBarTitleText": "我的页面",
"backgroundColor": "#efefef",
"backgroundTextStyle": "dark"
}
页面逻辑文件主要功能有:设置初始化数据,注册当前页面生命周期函数,注册事件处理函数等。小程序的逻辑层文件是JavaScript文件,所有的逻辑文件,包括app.js,最终会打包成一个.js文件,在小程序启动时运行直到小程序销毁,类似于ServiceWorker,所以逻辑层也称为App Service。
在小程序中,每个逻辑文件有独立的作用域,并具备模块化能力。由于JavaScript逻辑文件是运行在纯Java引擎中而非运行在浏览器中,一些浏览器提供的特有对象,如document、window等,在小程序中都无法使用,同理,一些基于document、window的框架如:jQuery、Zepto都不能在小程序中使用,同时我们不能通过操作DOM改变页面,这时需要我们将面向DOM操作的编程思路转换为数据绑定和事件响应。
1.注册页面
在页面逻辑文件中需要通过Page()函数注册页面,指定页面的初始数据、生命周期函数、事件处理函数等,参数为一个Object对象,其属性如下:
示例代码:
Page({
/**
* 页面的初始数据
*/
data: {
count:0
},
countClick:function(){
this.setData({
count:this.data.count+1
})
},
/**
* 生命周期函数--监听页面加载
*/
onLoad: function (options) {
},
/**
* 生命周期函数--监听页面初次渲染完成
*/
onReady: function () {
},
/**
* 生命周期函数--监听页面显示
*/
onShow: function () {
},
/**
* 生命周期函数--监听页面隐藏
*/
onHide: function () {
},
/**
* 生命周期函数--监听页面卸载
*/
onUnload: function () {
},
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
},
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
},
/**
* 用户点击右上角分享
*/
onShareAppMessage: function () {
},
customData:{
name:'微信'
/**
* 自定义数据
*/
}
})
页面的生命周期比小程序的生命周期函数略微复杂一点,弄到其执行顺序能避免在不恰当的生命周期函数中调用还未创建的对象或方法,小程序框架以栈的形式维护了当前的所有页面,当发生路由切换时,页面栈和声明周期函数的关系如下:
整体来说,如果页面在生命周期中,只会触发onShow和onLoad方法,只有加载和卸载是才会触发onLoad、onReady和onUnload方法,而触发页面卸载只有页面返回和页面重定向两种操作。
页面生命周期函数可以在开发过程中开启app.json中的debug模式,路由切换时,小程序、页面的生命周期函数执行顺序都会在控制台以Info形式输出
2.获取当前页面栈
有注册就有获取,getCurrentPages()函数遍试用于获取当前页面栈的实例,页面栈以数组形式按栈顺序给出,第一个元素为首页,最后一个元素为当前页
示例代码如下:
/*获取页面栈*/
var pages = getCurrentPages();
/*获取当前页面对象 */
var currentPage = pages[pages.length-1];
3.事件处理函数
页面对象中注册的函数和视图层中的组件进行绑定,当达到触发条件时,就会执行Page中定义的相应事件,这类自定义函数统称为事件处理函数。
示例代码如下:
点击执行逻辑层事件
Page({
myevent:function(){
console.log('点击了view');
}
});
4.触发视图层渲染
页面首次加载时,框架会结合初始化数据渲染页面,在逻辑层中则需主动调用Page.prototype.setData()方法,而不能直接修改Page的data值,这样不仅无法触发视图层渲染,还会造成数据不一致。当Page.prototype.setData()被调用时,会将数据从逻辑层发送到视图层触发视图层重绘,同时会修改Page的data值。setData()接收一个Object对象参数,方法会自动价格tihis.data中key对应的值一致时,将不会触发视图层渲染。在项目中我们一定要保证视图层和逻辑层的数据一致。
示例代码如下:
{{text}}
{{object.subObject.objectText}}
{{array[0].arrayText}}
{{newField.newFiledText}}
Page({
data: {
text:'normal data',
object:{
subObject:{
objectText:'object data'
}
},
array:[
{
arrayText:'object data'
}
]
},
changeText:function(){
this.setData({
/*普通索引 */
text:'new normal data'
});
},
changeObjectText:function(){
this.setData({
/*按路径索引*/
'object.subObject.objectText':'new object data'
});
},
changeArrayText:function(){
this.setData({
/*按路径索引 */
'array[0].arrayText':'new array data'
});
},
addNewData:function(){
this.setData({
/*修改一个已绑定,但未在data中定义的数据 */
'newField.newFieldText':'add new data'
});
}
});
5.页面生命周期
线程启动后视图层和逻辑层互相监听,当逻辑层线程触发onLoad、onShow方法后会把初始数据data传送给视图层线程,视图层完成第一次选然后触发逻辑层onReady方法,代表页面已经准备妥当,之后我们便可通过setData方法主动触发视图层渲染。当页面被调完后台时,触发onHide方法,这时逻辑层线程并没有被销毁,我们仍然可以通过代码控制视图层渲染,值是看你不会在界面上表现出来。当页面从后台回到前台时,触发onShow方法,最后当页面销毁时,触发onUnload方法。整体看onLoad、onReady和onUnload方法在生命周期中只会调用一次,生命周期内显示、隐藏页面都是触发onShow和onHide方法,在路由方式中,只有页面重定向和也i按返回结束当前页面生命周期,当进入一个已加载的页面时只会触发onShow方法,不会触发onLoad和onReady方法。