在写小程序的过程中会发现里面的有些使用和vue很相似,有相关基础上手并不是很难,难点主要在于js的逻辑交互,
小程序的启动
微信客户端在打开小程序之前,会把整个小程序的代码包下载到本地。
紧接着通过 app.json 的 pages 字段就可以知道你当前小程序的所有页面路径:1
2
3{ "pages":[ "pages/index/index", "pages/logs/logs"
]
}
这个配置说明在 QuickStart 项目定义了两个页面,分别位于 pages/index/index 和 pages/logs/logs 目录。而写在 pages 字段的第一个页面就是这个小程序的首页(打开小程序看到的第一个页面)。
于是微信客户端就把首页的代码装载进来,通过小程序底层的一些机制,就可以渲染出这个首页。
小程序启动之后,在 app.js 定义的 App 实例的 onLaunch 回调会被执行:1
2
3
4App({
onLaunch: function () { // 小程序启动之后 触发
}
})
整个小程序只有一个 App 实例,是全部页面共享的,更多的事件回调参考文档 注册程序 App 。
接下来我们简单看看小程序的一个页面是怎么写的。
程序与页面
你可以观察到 pages/logs/logs 下其实是包括了4种文件的,微信客户端会先根据 logs.json 配置生成一个界面,顶部的颜色和文字你都可以在这个 json 文件里边定义好。紧接着客户端就会装载这个页面的 WXML 结构和 WXSS 样式。最后客户端会装载 logs.js,你可以看到 logs.js 的大体内容就是:1
2
3
4
5
6
7Page({
data: { // 参与页面渲染的数据
logs: []
},
onLoad: function () { // 页面渲染后 执行
}
})
Page 是一个页面构造器,这个构造器就生成了一个页面。在生成页面的时候,小程序框架会把 data 数据和 index.wxml 一起渲染出最终的结构,于是就得到了你看到的小程序的样子。
在渲染完界面之后,页面实例就会收到一个 onLoad 的回调,你可以在这个回调处理你的逻辑。
有关于 Page 构造器更多详细的文档参考 注册页面 Page 。
组件
小程序提供了丰富的基础组件给开发者,开发者可以像搭积木一样,组合各种组件拼合成自己的小程序。
就像 HTML 的 div, p 等标签一样,在小程序里边,你只需要在 WXML 写上对应的组件标签名字就可以把该组件显示在界面上,例如,你需要在界面上显示地图,你只需要这样写即可:
需要注意的是:多数 API 的回调都是异步,你需要处理好代码逻辑的异步问题。
更多的 API 能力见 小程序的API 。
其实小程序的官网教程讲的也很明白透彻,看官方教程就可以了,而且小程序有丰富的组件,使用时很方便的,
更多的组件可以参考 小程序的组件 。
基础组件
为了让开发者可以很方便的调起微信提供的能力,例如获取用户信息、微信支付等等,小程序提供了很多 API 给开发者去使用。
要获取用户的地理位置时,只需要:1
2
3
4
5
6wx.getLocation({
type: 'wgs84',
success: (res) => { var latitude = res.latitude // 经度
var longitude = res.longitude // 纬度
}
})
调用微信扫一扫能力,只需要:1
2
3
4wx.scanCode({
success: (res) => { console.log(res)
}
})
框架为开发者提供了一系列基础组件,开发者可以通过组合这些基础组件进行快速开发。
什么是组件:
组件是视图层的基本组成单元。
组件自带一些功能与微信风格的样式。
一个组件通常包括开始标签和结束标签,属性用来修饰这个组件,内容在两个标签之内。1
2
3<tagname property="value">
Content goes here ...
</tagname>
注意:所有组件与属性都是小写,以连字符-连接
属性类型
类型 描述 注解
Boolean 布尔值 组件写上该属性,不管该属性等于什么,其值都为true,只有组件上没有写该属性时,属性值才为false。如果属性值为变量,变量的值会被转换为Boolean类型
Number 数字 1, 2.5
String 字符串 “string”
Array 数组 [ 1, “string” ]
Object 对象 { key: value }
EventHandler 事件处理函数名 “handlerName” 是 Page中定义的事件处理函数名
Any 任意属性
共同属性类型
所有组件都有的属性:
属性名 类型 描述 注解
id String 组件的唯一标示 保持整个页面唯一
class String 组件的样式类 在对应的 WXSS 中定义的样式类
style String 组件的内联样式 可以动态设置的内联样式
hidden Boolean 组件是否显示 所有组件默认显示
data- Any 自定义属性 组件上触发的事件时,会发送给事件处理函数
bind / catch* EventHandler 组件的事件 详见事件
特殊属性
几乎所有组件都有各自定义的属性,可以对该组件的功能或样式进行修饰,请参考各个组件的定义。
视图容器(View Container):
view 视图容器
scroll-view 可滚动视图容器
swiper 滑块视图容
基础内容(Basic Content):
icon 图标
text 文字
progress 进度条
表单(Form):
button 按钮
form 表单
input 输入框
checkbox 多项选择器
radio 单项选择器
picker 列表选择器
picker-view 内嵌列表选择器
slider 滚动选择器
switch 开关选择器
label 标签
导航(Navigation):
navigator 应用链接
多媒体(Media):
audio 音频
image 图片
video 视频
地图(Map):
map 地图
画布(Canvas):
canvas 画布