小程序开发框架的逻辑层(App Service)是由JavaScript编写。逻辑层将数据进行处理后发送给视图层,同时接受视图层的事件反馈。
- 增加
App
和Page
方法,进行程序和页面的注册。 - 增加
getApp
和getCurrentPages
方法,分别用来获取 App 实例和当前页面栈。 - 提供丰富的
API
,如微信用户数据,扫一扫,支付等微信特有能力。 - 每个页面有独立的
作用域
,并提供模块化
能力。 - 由于框架并非运行在浏览器中,所以 JavaScript 在 web 中一些能力都无法使用,如 document,window 等。
- 开发者写的所有代码最终将会打包成一份 JavaScript,并在小程序启动的时候运行,直到小程序销毁。类似 ServiceWorker,所以逻辑层也称之为 App Service。
注册程序
注册页面
模块化
注册程序
- App
App()
函数用来注册一个小程序。接受一个 object 参数,其指定小程序的生命周期函数等。
object参数说明.png
- 前台、后台定义: 当用户点击左上角关闭,或者按了设备 Home 键离开微信,小程序并没有直接销毁,而是进入了后台;当再次进入微信或再次打开小程序,又会从后台进入前台。只有当小程序进入后台一定时间,或者系统资源占用过高,才会被真正的销毁。
- getApp() 提供了全局的
getApp()
函数,可以获取到小程序实例。 - 注意:(1)
App()
必须在app.js
中注册,且不能注册多个。(2)不要在定义于App()
内的函数中调用getApp()
,使用this
就可以拿到 app 实例。(3)不要在 onLaunch 的时候调用getCurrentPage()
,此时 page 还没有生成。(4)通过getApp()
获取实例之后,不要私自调用生命周期函数。
注册页面
- Page
Page()
函数用来注册一个页面。接受一个 object 参数,其指定页面的初始数据、生命周期函数、事件处理函数等。
object参数说明.png
- 初始化数据 将作为页面的第一次渲染。data 将会以 JSON 的形式由逻辑层传至渲染层,所以其数据必须是可以转成 JSON 的格式:字符串,数字,布尔值,对象,数组。渲染层可以通过 WXML 对数据进行绑定。
示例代码
<view>{{text}}</view>
<view>{{array[0].msg}}</view>
Page({
data: {
text: 'init data',
array: [{msg: '1'}, {msg: '2'}]
}
})
- 生命周期函数
onLoad
: 页面加载 (1)一个页面只会调用一次。(2)接收页面参数可以获取wx.navigateTo
和wx.redirectTo
及<navigator/>
中的 query。
onShow
: 页面显示 (1)每次打开页面都会调用一次。
onReady
: 页面初次渲染完成 (1)一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。(2)对界面的设置如wx.setNavigationBarTitle请在onReady之后设置。
onHide
: 页面隐藏 (1)当navigateTo或底部tab切换时调用。
onUnload
: 页面卸载 (1)当redirectTo或navigateBack的时候调用。
- 页面相关事件处理函数
onPullDownRefresh: 下拉刷新(1)监听用户下拉刷新事件。(2)需要在config的window选项中开启enablePullDownRefresh。(3)当处理完数据刷新后,wx.stopPullDownRefresh可以停止当前页面的下拉刷新。
onShareAppMessage: 用户分享 (1)只有定义了此事件处理函数,右上角菜单才会显示“分享”按钮。(2)用户点击分享按钮的时候会调用。(3)此事件需要 return 一个 Object,用于自定义分享内容
自定义分享字段.png
- 事件处理函数 除了初始化数据和生命周期函数,Page 中还可以定义一些特殊的函数:事件处理函数。在渲染层可以在组件中加入事件绑定,当达到触发事件时,就会执行 Page 中定义的事件处理函数。
- Page.prototype.setData()
setData
函数用于将数据从逻辑层发送到视图层,同时改变对应的this.data
的值。
注意:
(1)直接修改 this.data 无效,无法改变页面的状态,还会造成数据不一致。
(2)单次设置的数据不能超过1024kB,请尽量避免一次设置过多的数据。
-
setData()
参数格式,接受一个对象,以 key,value 的形式表示将this.data
中的 key 对应的值改变成 value。其中 key 可以非常灵活,以数据路径的形式给出,如 array[2].message,a.b.c.d,并且不需要在this.data
中预先定义。 -
getCurrentPages()
函数用于获取当前页面栈的实例,以数组形式按栈的顺序给出,第一个元素为首页,最后一个元素为当前页面。Tip:不要尝试修改页面栈,会导致路由以及页面状态错误。 - 页面栈 框架以栈的形式维护了当前的所有页面。 当发生路由切换的时候,页面栈的表现如下:
页面栈表现.png
- Page实例的生命周期
page实例生命周期.png
- 页面的路由 在小程序中所有页面的路由全部由框架进行管理,对于路由的触发方式以及页面生命周期函数如下:
页面的路由.png
Tab 切换对应的生命周期(以 A、B 页面为 Tabbar 页面,C 是从 A 页面打开的页面,D 页面是从 C 页面打开的页面为例):
Tab对应的生命周期.png
模块化
- 文件作用域 在 JavaScript 文件中声明的变量和函数只在该文件中有效;不同的文件中可以声明相同名字的变量和函数,不会互相影响。通过全局函数
getApp()
可以获取全局的应用实例,如果需要全局的数据可以在App() 中
设置 - 模块化,可以将一些公共的代码抽离成为一个单独的 js 文件,作为一个模块。模块只有通过
module.exports
或者exports
才能对外暴露接口。
需要注意的是
exports 是 module.exports 的一个引用,因此在模块里边随意更改 exports 的指向会造成未知的错误。所以更推荐开发者采用 module.exports 来暴露模块接口,除非你已经清晰知道这两者的关系。
小程序目前不支持直接引入 node_modules , 开发者需要使用到 node_modules 时候建议拷贝出相关的代码到小程序的目录中。
在需要使用这些模块的文件中,使用 require(path) 将公共代码引入
如:var common = require('common.js')