1.配置文件
page.json
来决定
初始化项目的时候,文件自动生成app.json
来对小程序进行全局配置。
2.逻辑层(App Server)
小程序开发框架的逻辑层是由JavaScript
编写。
逻辑层
将数据进行处理后发送给视图层
,同时接受视图层
的事件反馈。 在 JavaScript
的基础上,做了一些修改,以方便地开发小程序。
1)增加 App
和 Page
方法,进行程序
和页面
的注册。
App()
函数用来注册一个小程序。接受一个 object
参数,其指定小程序的生命周期函数
等。
App.prototype.getCurrentPage()
getCurrentPage() 函数用户获取当前页面的实例。
var appInstance = getApp()
console.log(appInstance.globalData) // I am global data
2)App()
叫做注册程序,Page()
叫做注册页面
Page()
接受一个 object
参数,
指定页面的初始数据、生命周期函数、事件处理函数等
3)初始化数据
初始化数据将作为页面的第一次渲染。
data
将会以 JSON
的形式由逻辑层传至渲染层,所以其数据必须是可以转成JSON
的格式:字符串,数字,布尔值,对象,数组
。
渲染层可以通过WXML
对数据进行绑定。
eg:下面这个是一段wxml
的代码
<view>{{text}}</view>
<view>{{array[0].msg}}</view>
下面这个是一段.js
代码,data
是初始化页面数据
Page({
data: {
text: 'init data',
array: [{msg: '1'}, {msg: '2'}]
}
})
4)页面的生命周期函数
a)onLoad
: 页面加载
一个页面只会调用一次。
参数可以获取wx.navigateTo和wx.redirectTo及<navigator/>中的 query。这个是什么意思呢?
onLoad:function(options){
// options 就是参数
// options.redirect
}
b)onShow
: 页面显示
每次打开页面都会调用一次。
c)onReady
: 页面初次渲染完成
一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互
对界面的设置如wx.setNavigationBarTitle
请在onReady
之后设置
d)onHide
: 页面隐藏
当navigateTo
或底部tab
切换时调用。
e)onUnload
: 页面卸载
当redirectTo
或navigateBack
的时候调用。
5)页面相关事件处理函数
onPullDownRefresh
: 下拉刷新
监听用户下拉刷新事件。
需要在config
的window
选项中开启enablePullDownRefresh
。
6)事件处理函数
除了初始化数据和生命周期函数,Page
中还可以定义一些特殊的函数:事件处理函数
。在渲染层可以在组件中加入事件绑定
,当达到触发事件时,就会执行Page
中定义的事件处理函数
。
eg:
// .wxml
<view bindtap="tap_view"> click me!</view>
// .js
Page({
tap_view:function(){
console.log('view taped!');
}
})
7)Page.prototype.setData()
setData
函数用于将数据
从逻辑层
发送到视图层
,同时改变对应的this.data
的值。
注意:
1.直接修改 this.data
无效,无法改变页面的状态,还会造成数据不一致。
2.单次设置的数据不能超过1024kB
,请尽量避免一次设置过多的数据。
<!--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
this.setData({
'array[0].text':'changed data'
})
},
changeItemInObject: function(){
this.setData({
'object.text': 'changed data'
});
},
addNewField: function() {
this.setData({
'newField.text': 'new data'
})
}
})
这里的this
指的是.js
文件
8).页面的路由
小程序
中所有页面的路由全部由框架
进行管理
路由方式:
a.初始化
打开新页面:调用 API wx.navigateTo
或使用组件<navigator />
(节点方式)
b.打开新页面,相当于iOS中的nav
的push
调用 API wx.navigateTo
或使用组件 <navigator />
,调用后路由前页面函数:onHide
c.页面重定向
调用 API wx.redirectTo
或使用组件 <navigator />
,调用后路由前页面函数:onUnload
d.页面返回
调用 API wx.navigateBack
或用户按左上角返回
按钮
e.Tab切换
多Tab
模式下用户切换Tab
9)文件作用域
在 JavaScript
文件中声明的变量
和函数
只在该文件中有效;不同的文件中可以声明相同名字的变量和函数,不会互相影响。
通过全局函数 getApp()
可以获取全局的应用实例
,如果需要全局的数据可以在 App()
中设置
10)模块化
我们可以将一些公共的代码抽离成为一个单独的js
文件,作为一个模块。模块只有通过 module.exports
才能对外暴露接口。
module.exports = {
sayHello: sayHello
}
function sayHello(name){
console.log('Hello' + name + '!');
}
// 使用
var common = require('common.js');
Page({
helloMaer:function(){
common.sayHello('Maer');
}
})
11)API
小程序开发框架提供许多原生api
,可以方便的掉漆微信提供的功能,eg
:获取用户信息,本地存储,微信支付等.
wx.on
开头的API
是监听某个时间发生的API
接口,接受一个CALLBACK
函数作为参数。当该时间触发的时候,会调用callback
函数。
如果没有特殊约定,其他的api
接口都接受一个object
作为参数。
object
中可以指定success
, fail
, complete
来接收接口调用结果。
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)
这里举例几个常用的api
接口:
wx.request 发起的是https请求。**一个微信小程序,同时只能有5个网络请求连接。**
数据 API 列表:
wx.getStorage // 获取本地数据缓存
wx.setStorage // 设置本地数据缓存
wx.clearStorage // 清除本地数据缓存
获取网络类型
wx.getNetworkType(OBJECT)
eg:
wx.getNetworkType({
success:function(res){
var networkType = res.networkType; // 返回网络类型2g,3g,4g,wifi
}
})
界面 API 列表:
参考:https://mp.weixin.qq.com/debug/wxadoc/dev/api/
3.视图层
框架的视图层由WXML
与 WXSS
编写,由组件
来进行展示。
将逻辑层
的数据反应成视图,同时将视图层
的事件发送给逻辑层。
组件
(Component
)是视图的基本组成单元。
1)WXML
WXML(WeiXin Markup Language)是框架设计的一套标签语言,结合基础组件、事件系统,可以构建出页面的结构。
wxml作用主要有:数据绑定、列表渲染、条件渲染、模板、事件、引用
数据绑定:
// wxml
<view>{{message}}</view>
// page.js
Page({
data:{
message: 'Hello world'!
}
})
列表渲染
// wxml
<view wx:for="{{array}}">{{item}}</view>
// page.js
Page({
data:{
array:[0, 1, 2, 3, 4]
}
})
条件渲染
<!--wxml--><view wx:if="{{view == 'WEBVIEW'}}"> WEBVIEW </view>
<view wx:elif="{{view == 'APP'}}"> APP </view>
<view wx:else="{{view == 'MINA'}}"> MINA </view>
// page.js
Page({
data: {
view: 'MINA'
}
})
<block/>
并不是一个组件,它仅仅是一个包装元素
,不会在页面中做任何渲染
,只接受控制属性
<block wx:if="{{true}}">
<view> view1 </view>
<view> view2 </view>
</block>
模板
总结:在属性中的值都要加“”.<template is="staffName" data="{{...staffA}}"></template>
扩展运算符...
来将一个对象展开
Page({
data:{
staffA:{firstname:'a', lastname:'b'}
}
})
注意: 如果
js:
Page({
data:{
foo:'a',
bar:'b'
}
})`
<template data={{foo, bar}}>
data组合对象为:{foo:'a', bar:'b'}
<template data={{'A':foo, 'B':bar}}>
data组合对象为:{'A':'a', 'B':'b'}
模板拥有自己的作用域,只能使用data
传入的数据。
事件
eg:
<view bindtap="add">{{count}}</view>
Page({
data:{
count:1
}
add: function(e){
this.setData({
count:this.data.count + 1
})
}
})
2)wxml
为了适应广大的前端开发者,WXSS
具有 CSS
大部分特性。 同时为了更适合开发微信小程序,对 CSS
进行了扩充以及修改。
尺寸单位
rpx(responsive pixel)
规定屏幕宽为750rpx
样式导入
使用@import
语句可以导入外联样式表
,@import
后跟需要导入的外联样式表
的相对路径,用;
表示语句结束。