小程序代码的构成
WXML 和 HTML 的区别
标签名称不同
- HTML (div, span, img, a)
- WXML(view, text, image, navigator)
属性节点不同
- <a href="#">超链接</a>
- <navigator url="/pages/home/home"></navigator>
提供了类似于 Vue 中的模板语法
- 数据绑定
- 列表渲染
- 条件渲染
WXSS 和 CSS 的区别
新增了 rpx 尺寸单位
- CSS 中需要手动进行像素单位换算,例如 rem
- WXSS 在底层支持新的尺寸单位 rpx,在不同大小的屏幕上小程序会自动进行换算
提供了全局的样式和局部样式
- 项目根目录中的 app.wxss 会作用于所有小程序页面
- 局部页面的 .wxss 样式仅对当前页面生效
WXSS 仅支持部分 CSS 选择器
- .class 和 #id
- element
- 并集选择器、后代选择器
- ::after 和 ::before 等伪类选择器
小程序中 .js 文件的分类
小程序中的 JS 文件分为三大类,分别是:
app.js
- 是整个小程序项目的入口文件,通过调用 App() 函数来启动整个小程序
页面的 .js 文件
- 是页面的入口文件,通过调用 Page() 函数来创建并运行页面
普通的 .js 文件
- 是普通的功能模块文件,用来封装公共的函数或属性供页面使用
小程序宿主环境包含的内容
通信模型
- 渲染层和逻辑层之间的通信:由微信客户端进行转发
- 逻辑层和第三方服务器之间的通信:由微信客户端进行转发
编辑
运行机制
小程序启动的过程
- 把小程序的代码包下载到本地
- 解析 app.json 全局配置文件
- 执行 app.js 小程序入口文件, 调用 App() 创建小程序实例
- 渲染小程序首页
- 小程序启动完成
页面渲染的过程
- 加载解析页面的 .json 配置文件
- 加载页面的 .wxml 模板和 .wxss 样式
- 执行页面的 .js 文件, 调用 Page() 创建页面实例
- 页面渲染完成
组件
小程序中的组件也是由宿主环境提供的,开发者可以基于组件快速搭建出漂亮的页面结构。官方把小程序的组件分为了 9 大类
常用的视图容器类组件
view
- 普通视图区域
- 类似于 HTML 中的 div,是一个块级元素
- 常用来实现页面的布局效果
编辑
scroll-view
- 可滚动的视图区域
- 常用来实现滚动列表效果
编辑
swiper 和 swiper-item
- 轮播图容器组件 和 轮播图 item 组件
编辑
编辑
常用的基础内容组件
text
- 文本组件
- 类似于 HTML 中的 span 标签,是一个行内元素
编辑
rich-text
- 富文本组件
- 支持把 HTML 字符串渲染为 WXML 结构
编辑
其它常用组件
button
- 按钮组件
- 功能比 HTML 中的 button 按钮丰富
- 通过 open-type 属性可以调用微信提供的各种功能(客服、转发、获取用户授权、获取用户信息等)
编辑
image
- 图片组件
- image 组件默认宽度约 300px、高度约 240px
编辑
编辑
navigator(后面课程会专门讲解)
- 页面导航组件
- 类似于 HTML 中的 a 链接
API
事件监听 API
- 特点:以 on 开头,用来监听某些事件的触发
- 举例: wx.onWindowResize(function callback) 监听窗口尺寸变化的事件
同步 API
- 特点1:以 Sync 结尾的 API 都是同步 API
- 特点2:同步 API 的执行结果,可以通过函数返回值直接获取,如果执行出错会抛出异常
- 举例: wx.setStorageSync('key', 'value') 向本地存储中写入内容
异步 API
- 特点:类似于 jQuery 中的 $.ajax(options) 函数,需要通过 success 、fail 、complete 接收调用 的结果
- 举例: wx.request() 发起网络数据请求,通过 success 回调函数接收数据
协同工作和发布
小程序的开发流程
编辑
运营数据
在“小程序后台”查看
- 登录小程序管理后台
- 点击侧边栏的“统计”
- 点击相应的 tab 可以看到相关的数据
使用“小程序数据助手”查看
- 打开微信
- 搜索“小程序数据助手”
- 查看已发布的小程序相关的数据
WXML 模板语法 - 数据绑定
在页面对应的 .js 文件中,把数据定义到 data 对象中;把data中的数据绑定到页面中渲染,使用 Mustache 语法(双大括号) 将变量包起来即可
Mustache 语法的主要应用场景如下:
- 绑定内容
编辑
- 绑定属性
编辑
- 运算(三元运算、算术运算等)
编辑
编辑
WXML 模板语法 - 事件绑定
小程序中常用的事件
编辑
事件对象的属性列表
当事件回调触发的时候,会收到一个事件对象 event
编辑
target 和 currentTarget 的区别
- target 是触发该事件的源头组件
- currentTarget 则是当前事件所绑定的组件
点击内部的按钮时,点击事件以冒泡的方式向外扩散,也会触发外层 view 的 tap 事件处理函数。此时,对于外层的 view 来说:
编辑
- e.target 指向的是触发事件的源头组件,因此,e.target 是内部的按钮组件
- e.currentTarget 指向的是当前正在触发事件的那个组件,因此,e.currentTarget 是当前的 view 组件
bindtap 的语法格式
在小程序中,不存在 HTML 中的 onclick 鼠标点击事件,而是通过 tap 事件来响应用户的触摸行为
- 通过 bindtap,可以为组件绑定 tap 触摸事件
编辑
- 在页面的 .js 文件中定义对应的事件处理函数,事件参数通过形参 event(一般简写成 e) 来接收
编辑
- 在事件处理函数中为 data 中的数据赋值
通过调用 this.setData(dataObject) 方法,可以给页面 data 中的数据重新赋值
编辑
- 事件传参
小程序中的事件传参比较特殊,不能在绑定事件的同时为事件处理函数传递参数。例如:
编辑
小程序会把 bindtap 的属性值,统一当作事件名称来处理,相当于要调用一个名称为 btnHandler(123)的事件处理函数。
可以为组件提供 data-* 自定义属性传参,其中 * 代表的是参数的名字
编辑
- info 会被解析为参数的名字
- 数值 2 会被解析为参数的值
在事件处理函数中,通过 event.target.dataset.参数名 即可获取到具体参数的值
编辑
bindinput 的语法格式
在小程序中,通过 input 事件来响应文本框的输入事件
- 通过 bindinput,可以为文本框绑定输入事件
编辑
- 在页面的 .js 文件中定义事件处理函数
编辑
- 实现文本框和 data 之间的数据同步
定义数据:
编辑
渲染结构:
编辑
美化样式:
编辑
绑定 input 事件处理函数
编辑
WXML 模板语法 - 条件渲染
wx:if
- 在小程序中,使用 wx:if="{{condition}}" 来判断是否需要渲染该代码块
编辑
- 也可以用 wx:elif 和 wx:else 来添加 else 判断:
编辑
结合 <block> 使用 wx:if
如果要一次性控制多个组件的展示与隐藏,可以使用一个 <block></block> 标签将多个组件包装起来, 并在<block> 标签上使用 wx:if 控制属性
PS:<block> 并不是一个组件,它只是一个包裹性质的容器, 不会在页面中做任何渲染
编辑
hidden
在小程序中,直接使用 hidden="{{ condition }}" 也能控制元素的显示与隐藏
编辑
wx:if 与 hidden 的对比
运行方式不同
- wx:if 以动态创建和移除元素的方式,控制元素的展示与隐藏
- hidden 以切换样式的方式(display: none/block;),控制元素的显示与隐藏
使用建议
- 频繁切换时,建议使用 hidden
- 控制条件复杂时, 建议使用 wx:if 搭配 wx:elif 、wx:else 进行展示与隐藏的切换
wx:for
通过 wx:for 可以根据指定的数组,循环渲染重复的组件结构
PS:默认情况下,当前循环项的索引用 index 表示; 当前循环项用 item 表示。
编辑
手动指定索引和当前项的变量名*
- 使用 wx:for-index 可以指定当前循环项的索引的变量名
- 使用 wx:for-item 可以指定当前项的变量名
编辑
wx:key 的使用
类似于 Vue 列表渲染中的 :key,小程序在实现列表渲染时, 也建议为渲染出来的列表项指定唯一的 key 值,从而提高渲染的效率
编辑
WXSS 模板样式
WXSS 扩展的特性有
rpx 尺寸单位
rpx(responsive pixel)是微信小程序独有的,用来解决屏适配的尺寸单位;为了实现屏幕的自动适配, rpx 把所有设备的屏幕,在宽度上等分为 750 份
@import 样式导入
导入外联的样式表
PS:相对路径
编辑
WXSS 模板样式 - 全局样式和局部样式
- 定义在 app.wxss 中的样式为全局样式,作用于每一个页面
- 在页面的 .wxss 文件中定义的样式为局部样式,只作用于当前页面。
PS:当局部样式和全局样式冲突时,根据就近原则,局部样式会覆盖全局样式
全局配置
小程序根目录下的 app.json 文件是小程序的全局配置文件。常用的配置项如下
pages
- 记录当前小程序所有页面的存放路径
window
- 全局设置小程序窗口的外观
tabBar
- 设置小程序底部的 tabBar 效果
style
- 是否启用新版的组件样式
小程序窗口的组成部分
编辑
了解 window 节点常用的配置项
编辑
全局开启下拉刷新功能
下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据的行为。设置步骤: app.json -> window -> 把 enablePullDownRefresh 的值设置为 true
设置下拉刷新时窗口的背景色
当全局开启下拉刷新功能之后,默认的窗口背景为白色。如果自定义下拉刷新窗口背景色,设置步骤为:app.json -> window -> 为 backgroundColor 指定16进制的颜色值 #efefef
编辑
设置下拉刷新时 loading 的样式
当全局开启下拉刷新功能之后,默认窗口的 loading 样式为白色,如果要更改 loading 样式的效果,设置步骤为 app.json -> window -> 为 backgroundTextStyle 指定 dark 值
编辑
PS:backgroundTextStyle 的可选值只有 light 和 dark
全局配置 - tabBar
tabBar 是移动端应用常见的页面效果, 用于实现多页面的快速切换。小程序中通常将其分为:
- 底部 tabBar
- 顶部 tabBar
编辑
PS:tabBar中只能配置最少 2 个 、最多 5 个 tab 页签;当渲染顶部 tabBar 时, 不显示 icon,只显示文本
tabBar 的 6 个组成部分
- backgroundColor:tabBar 的背景色
- selectedIconPath:选中时的图片路径
- borderStyle:tabBar 上边框的颜色
- iconPath:未选中时的图片路径
- selectedColor:tab 上的文字选中时的颜色
- color:tab 上文字的默认(未选中)颜色
- list:tab 页签的列表,最少 2 个 、最多 5 个 tab
- pagePath:页面路径,页面必须在 pages 中预先定义
- text:tab 上显示的文字
编辑
编辑
页面配置
每个页面都有自己的 .json 配置文件,用来对当前页面的窗口外观、页面效果等进行配置
页面配置中常用的配置项
编辑
页面配置和全局配置的关系
可以全局配置小程序中每个页面的窗口表现。如果某些小程序页面想要拥有特殊的窗口表现,此时,“页面级别的.json 配置文件”就可以实现这种需求
PS:当页面配置与全局配置冲突时,根据就近原则,最终的效果以页面配置为准
网络数据请求
小程序中网络数据请求的限制
出于安全性方面的考虑,小程序官方对数据接口的请求做出了如下两个限制:
- 只能请求 HTTPS 类型的接口
- 必须将接口的域名添加到信任列表中
发起 GET 请求
调用微信小程序提供的 wx.request() 方法,可以发起 GET 数据请求
编辑
发起 POST 请求
调用微信小程序提供的 wx.request() 方法,可以发起 POST 数据请求
编辑
在页面刚加载时请求数据
需要在页面刚加载的时候 , 自动请求一些初始化的数据。此时需要在页面的 onLoad 事件中调用获取数据的函数
编辑
跳过 request 合法域名校验
如果后端程序员仅仅提供了 http 协议的接口 、暂时没有提供 https协议的接口。此时为了不耽误开发的进度, 我们可以在微信开发者工具中,临时开启「开发环境不校验请求域名、 TLS 版本及 HTTPS 证书」选项, 跳过 request 合法域名的校验。
编辑
PS:跳过 request 合法域名校验的选项,仅限在开发与调试阶段使用!!!
关于跨域和 Ajax 的说明
- 跨域问题只存在于基于浏览器的 Web 开发中。由于小程序的宿主环境不是浏览器,而是微信客户端,所以小程序中不存在跨域的问题
- Ajax 技术的核心是依赖于浏览器中的 XMLHttpRequest 这个对象,由于小程序的宿主环境是微信客户端,所以小程序中不能叫做“发起 Ajax 请求”,而是叫做“发起网络数据请求”