第一章微信小程序概述总结
如何认识小程序？
1.1 小程序简介
1.2小程序的特征
1.3 小程序应用场景的特点
1.4 微信小程序开发流程
1.5 下载微信小程序开发中工具APP
微信开发者功能介绍
（1）工具栏
（2）模拟区
（3）目录文件区
（4）编辑区
（5）调试区
调试区功能介绍
第二章 微信小程序开发基础总结
2.1 小程序的基本目录结构
2.1.1主页文件
2.1.2页面文件
2.2 小程序开发框架
2.2.1视图层
2.2.2 逻辑层
2.2.3数据层
2.3创建另一个页面
2.3.1创建另一个页面文件
2.4 配置文件
2.4.1 全局配置文件
2.4.2页面配置文件
2.5逻辑文件
2.5.1.项目逻辑文件
2.5.2页面逻辑文件
2.6页面文件
2.6.1.数据绑定
2.6.2条件数据绑定
2.6.3列表数据绑定
2.6.4 模板
2.6.5 引用页面文件
2.6.6 页面事件
2.7 页面样式文件
第三章页面布局总结
3.1 盒子模型
3.2 块元素与行内元素
3.2.1 块级元素
3.2.2 行内元素
3.2.3 行内块元素
3.3 浮动与定位
3.3.1 元素浮动与清除
3.3.2 元素定位
（1）默认值 (static)
（2）相对定位 (relative)
（3）绝对定位 （absolute）
（4）固定定位 （fixed）
3.4 flex布局
3.4.1 容器属性
3.4.2 项目属性
第一章微信小程序概述总结
如何认识小程序？
1.1 小程序简介
微信（WeChat）小程序是腾讯公司于2011年1月21日退出的一款智能终端提供即时通信（Instant Messaging,IM）服务的应用程序，小程序是一种不需要下载安装级可使用的应用。
1.2小程序的特征
（1）无需安装
（2）触手可及
（3）用完即走
（4）无需加载
1.3 小程序应用场景的特点
（1）简单的业务逻辑
简单是指应用本身的业务逻辑。例如："小黄车"
（2）低频度的使用场景
低频度是小程序使用场景的另一个特点。例如："猫眼"
1.4 微信小程序开发流程
第一步：在微信公众号平台上注册小程序账号
第二步：下载开发者工具进行编码
第三步：通过开发者工具提交代码，通过审核后便可发布
1.5 下载微信小程序开发中工具APP
学习这本课程中，首先，需要安装一个软件APP，之后注册一个微信小程序账号。
微信开发者功能介绍
微信小程序界面划分于5大区域：工具栏、模拟区、目录文件区、编辑区和调试区。
（1）工具栏
实现多种功能，例如账号切换，小程序编译、清理存缓、预览等
（2）模拟区
在模拟区中选择手机类型、显示比例、网络类型，模拟器会显示运行效果
（3）目录文件区
用来显示当前的目录结构
（4）编辑区
用来实现对代码的编辑操作，编辑区中支持对.wxml、.wxss、.js及.json文件的操作。
5）调试区
调试区的功能是帮助开发者进行代码调试及排查有问题的区域，小程序系统为开发者提供了9个调试功能模块，分别是Console、Sources、Nekwork、Security、Storage、AppData、Wxml、Sensor和Trace。最右边的扩展菜单项：是控制开发工具按钮。
调试区功能介绍
（1)Console面板
Console面板是控制台，是调试小程序的控制面板，当代码执行错误时，错误信息将显示在控制Console面板中，便于开发者排查错误。
（2）Sources面板
Sources面板是源码，用于显示当前项目的脚本文件，例如：微信开放文档
（3）Network面板
Network面板是请求网络调试信息页，用于显示当前项目的脚本文件
（4）Security面板
Security面板是安全人证信息页，开发者可以通过该面板调试当前的网页的安全和认证等问题。如果安全设置安全论证，则会显示“The security of this page is unknown.
(5)Storage面板
Storage面板是数据库存储信息页
（6）AppData面板
AppData面板是实时数据信息页，用于显示被激活的所有页面的数据情况
（7）Wxml面板
Wxml面板是布局信息页，主要用于调试Wxml组件和相关CSS样式，显示Wxml转化后的界面。
（8）Sensor面板
Sensor面板是重力传感器信息页，用于调试重力感应API
(9)Trace面板
Trace面板是路由跟踪信息页，开发者在这里可以追踪连接到电脑中的安装的路由信息
第二章 微信小程序开发基础总结
2.1 小程序的基本目录结构
2.1.1主页文件
微信小程序的主体部分由３ 个文件组成, 这３ 个文件必须放在项目的主目录中, 负责小程序的整体配置, 它们的名称是固定的。
（1）app.js:小程序逻辑页面，主要用来注册小程序全局实例。
（2）app.json:小程序公共配置文件，配置小程序全局设置。
（3）app.wxss:小程序主样式表文件，类似的HTML的.CSS文件。
2.1.2页面文件
小程序通常是由多个页面组成的, 每个页面包含４ 个文件, 同一页面的这４ 个文件必须具有相同的路径与文件名。 当小程序被启动或小程序内的页面进行跳转时, 小程序会根据app.json设置的路径找到相对应的资源进行数据绑定。
（1）.js文件：页面逻辑文件，在该文件中编写JavaScript代码控制页面的逻辑。
（2）.wxml:页面结构文件，用于设计页面的布局、数据绑定等。
（3）.wxss：页面样式表文件，用于定义本页面中用到的各类样式表。
（4）.json：页面配置文件，该文件在页面中不可缺少。
2.2 小程序开发框架
2.2.1视图层
MINA框架的视图层由WXML与WXSS 编写，由组件来进行展示，.wxml文件用于描述页面的结构； .wxss文件用于描述页面的样式。
2.2.2 逻辑层
逻辑层用于处理事务逻辑。
微信小程序开发框架的逻辑层是采用javaScrict编写的。 在javaScrict的基础上, 微信团队做了适当修改, 以便提高开发小程序的效率。 主要修改包括:
(１) 增加app()和Page()方法, 进行程序和页面的注册。
(２) 提供丰富的API, 如扫一扫、支付等微信特有的能力。
(３) 每个页面有独立的作用域, 并提供模块化能力。
2.2.3数据层
数据层在逻辑上包括页面临时数据或缓存文件存储（本地存储）和网络存储与调用。
（1）页面临时数据或缓存
（2）文件存储（本地存储）
wx.getStorage:获取本地数据缓存
wx.setStorage:设置本地数据缓存
wx.clearStorage:清理本地数据缓存
（3）网络存储与调用
wx.request: 发起网络请求
wx.uploadFile: 上传文件
wx.downloadFile: 下载文件
调用URL的API接口，如下：
wx.navigateTo ：新窗口打开页面
wx.redirectTo: 原窗口打开页面
第三章页面布局总结
3.1 盒子模型
在页面设计中, 只有掌握了盒子模型以及盒子模型的各个属性和应用方法, 才能轻松控制页面中的各个元素。 盒子模型就是我们在页面设计中经常用到的一种思维模型。 在CSS 中, 一个独立的盒子模型由内容(content)、内边距(padding)、边框(border)和外边距(margin) ４ 个部分组成, 如图3-1所示。
盒子模型结构
此外, 对padding、border 和margin 可以进一步细化为上、下、左、右４ 个部分, 在CSS可以分别进行设置, 如图所示。
图中各元素的含义如下:
■ width 和height 内容的宽度和高度。
■ padding-top、padding-right、padding-bottom 和padding-left 上内边距、右内边距、底内边距和左内边距。
■ padding-top、padding-right、padding-bottom 和padding-left 上边框、右边框、底边框和左边框。
简单来说，一个盒子实际所占有的高度应该由"内容"+"内边距"＋"边框"+"外边距"，例如：
.box{
width:70px;
padding:5px;
marigin:10px;
}3.2 块元素与行内元素
概念：块级元素默认占一行高度, 一行内通常只有一个块级元素(浮动后除外), 添加新的块级元素时, 会自动换行, 块级元素一般作为盒子出现。
3.2.1 块级元素
(１) 一个块级元素占一行。
(２) 块级元素的默认高度由内容决定, 除非自定义高度。
(３) 块级元素的默认宽度是父级元素的内容区宽度, 除非自定义宽度。
(４) 块级元素的宽度、高度、外边距及内边距都可以自定义设置。
(５) 块级元素可以容纳块级元素和行内元素。 < view/ > 组件默认为块级元素, 使用<view/ > 组件演示盒子模型及块级元素。
3.2.2 行内元素
概念：行内元素, 不必从新一行开始, 通常会与前后的其他行内元素显示在同一行中, 它们不占有独立的区域, 仅靠自身内容支撑结构, 一般不可以设置大小, 常用于控制页面中文本的样式。 将一个元素的display 属性设置为inline 后, 该元素即被设置为行内元素。
行内元素的特点
(１) 行内元素不能被设置高度和宽度, 其高度和宽度由内容决定。
(２) 行内元素内不能放置块级元素, 只级容纳文本或其他行内元素。
(３) 同一块内, 行内元素和其他行内元素显示在同一行。
< text/ > 组件默认为行内元素, 使用< view/ > 及< text/ > 组件演示盒子模型及行内元素
3.2.3行内快元素
概念：当元素的display 属性被设置为inline-block时, 元素被设置为行内块元素。 行内块元素可以被设置高度、宽度、内边距和外边距。
3.3浮动与定位
3.3.1 元素浮动与清除
概念：元素浮动就是指设置了浮动属性的元素会脱离标准文档流的控制, 移到其父元素中指定位置的过程。 在CSS中, 通过float 属性来定义浮动。
none——默认值，表示元素不浮动；
left——元素向左浮动
right——元素向右浮动
3.3.2 元素定位
概念：浮动布局虽然灵活, 但无法对元素的位置进行精确的控制。 在CSS 中, 通过position属性可以实现对页面元素的精确定位。
static———默认值, 该元素按照标准流进行布局;
relative———相对定位, 相对于它在原文档流的位置进行定位, 它后面的盒子仍以标准流方式对待它;
absoulute———绝对定位, 相对于其上一个已经定位的父元素进行定位, 绝对定位的盒子从标准流中脱离, 它对其后的兄弟盒子的定位没有影响;
fixed———固定定位, 相对于浏览器窗口进行定位。
3.4 flex布局
概念：flex 布局是万维网联盟(WoeldWideWebConsortium,W3C) 在２００９ 年提出的一种新布局方案, 该布局可以简单快速地完成各种可以伸缩的设计, 以便很好地支持响应式布局。flex 是flexiblebox 的缩写, 意为弹性盒子模型, 可以简便、完整、响应式地实现各种页面布局。
布局：
flex 布局是万维网联盟（World Wide Web Consortium，W3C）在2009年提出的一种新布局方案，该布局可以简单快速地完成各种可以伸缩的设计，以便很好地支持响应式布局flex是flexible box的缩写，意为弹性盒子模型，可以简便、完整、响应式地实现各种页面布局。
flex 布局主要由容器和项目组成，采用flex 布局的元素称为 flex 容器（flex container)flex布局的所有直接子元素自动成为容器的成员，称为fex项目（flex item）。
容器默认存在两根轴：水平的主轴（main axis)和垂直的交叉轴（cross axis)。主轴开始位置（与边框的交叉点)叫做main start，结束位置叫做main end；交叉轴的开始位置做cross start，结束位置叫做cross end。
项目默认沿主轴排列。单个项目占据的主轴空间叫做main size，cross size。flex布局模型如图所示。
设置display 属性可以将一个元素指定为fex布局，设置fex-direction 属性可以指定轴方向。主轴既可以是水平方向，也可以是垂直方向。
flex 布局主要由容器和项目组成, 采用flex 布局的元素称为flex容器(flexcontainer),flex 布局的所有直接子元素自动成为容器的成员, 称为flex项目(flexitem)。
容器默认存在两根轴: 水平的主轴和垂直的交叉轴。 主轴的开始位置(与边框的交叉点) 叫做mainstart, 结束位置叫做mained; 交叉轴的开始位置叫做crosstart, 结束位置叫做crossend。 项目默认沿主轴排列。 单个项目占据的主轴空间叫做mainsize, 占据的交叉轴空间叫做crossize。 flex 布局模型如图所示。
3.4.1 容器属性
flex容器支持的属性又七种，如图所示：
（1）display
display用来指定元素是否为flex 布局, 语法格式为:
.box{display:flex|inline-flex;}
flex———块级flex布局, 该元素变为弹性盒子;
inline-flex———行内flex 布局, 行内容器符合行内元素的特征, 同时在容器内又符合flex 布局规范。
设置了flex布局之后, 子元素的float、clear 和vertical-align属性将失效。
(2)flex-direction
用于设置主轴的方向, 即项目排列的方向, 语法格式为:
.box{display:flex|inline-flex;}row———主轴为水平方向, 起点在左端, 当元素设置为 flex布局时, 主轴默认为row;
row-reverse———主轴为水平方向, 起点在右端;
column———主轴为垂直方向, 起点在顶端;
column-reverse———主轴为垂直方向, 起点在底端
(2)flex-direction
用于设置主轴的方向, 即项目排列的方向, 语法格式为:
.box{flex-direction:row|row-reverse|column|column-reverse;}(3)flex-wrap
用来指定项目在一根轴线的排列位置不够时，项目是否换行，其语法格式为：
.box{flex-wrap:nowrap|wrap|wrap-reverse;}(4) flex-flow
flex-flow是flex-direction 和flex-wrap 的简写形式, 默认值为row nowrap。 语法格式如下:
.box{flex-flow:<flex-direction>||<flex-wrap>;}(5)justify-content
justify-content 用于定义项目在主轴上的对齐方式。 语法格式如下:
.box{justify-content:flex-start|flex-end|center|space-between|space-around;}justify-content———与主轴方向有关, 默认主轴水平对齐, 方向从左到右;
flex-start———左对齐, 默认值;
flex-end———右对齐;
center———居中;
space-between———两端对齐, 项目之间的间隔都相等;
space-around———每个项目两侧的间隔相等。
(6)align-items
align-items用于指定项目在交叉轴上的对齐方式, 语法格式如下:
.box{align-items:flex-start|flex-end|center|baseline|stretch;}align-items———与交叉轴方向有关, 默认交叉由上到下;
flex-start———交叉轴起点对齐;
flex-end———交叉轴终点对齐;
center———交叉轴中线对齐;
baseline———项目根据它们第一行文字的基线对齐;
stretch———如果项目未设置高度或设置为auto, 项目将在交叉轴方向拉伸填充容器, 此为默认值。
(7)align-content
align-content 用来定义项目有多根轴线(出现换行后) 在交叉轴上的对齐方式, 如果只有一根轴线, 该属性不起作用。 语法格式如下:
.box{align-content;flex-start|flex-end|center|space-between|space-around|stretch}
apace-between——与交叉轴两端对齐, 轴线之间的间隔平均分布;
space-around——每根轴线两侧的间隔都相等, 轴线之间的间隔比轴线与边框间隔大一倍。 其余各属性值的含义与align-items属性的含义相同。
3.4.2 项目属性
容器内的项目支持六个属性，如图所示：
（1）order
order属性定义项目的排列顺序, 数值越小, 排列越靠前, 默认值为０。 语法格式如下:
.item{order:<number>;}（2）flex-grow
定义项目的放大比例, 默认值为０, 即不放大。 语法格式如下:
.item{flex-grow:<number>;}（3）flex-shink
用来定义项目的缩小比例, 默认值为１, 如果空间不足, 该项目将被缩小。语法格式如下:
.item{flex-shink:<number>;}（4）flex-basis
属性用来定义伸缩项目的基准值, 剩余的空间将按比例进行缩放, 它的默认值为auto (即项目的本来大小)。 语法格式如下:
.item{flex-basis:<numner>|auto;}(5)flex
属性是flex-grow、flex-shrink 和flex-basis 的简写, 其默认值分别为０、１、auto。语法格式如下:
.item{<flex-grow>|<flex-shrink>|<flex-basis>;}（6)align-self
属性用来指定单独的伸缩项目在交叉轴上的对齐方式。 该属性会重写默认的对齐方式。 语法格式如下:
.item{aligin-self:auto|flex-start|flex-end|center|baseline|stretch;}在该属性值中, 除了auto以外, 其余属性值和容器align-items的属性值完全一致。 auto表示继承容器align-items的属性, 如果没有父元素, 则等于stretch (默认值)。
第四章页面组件
4.1组件的定义以及属性
组件是页面视图层(WXML)的基本组成单元，组件组合可以构建功能强大的页面结构。小程序框架为开发者提供了容器视图、基础内容、表单、导航、多媒体、地图、画布开放能力等8类(30多个)基础组件。
每一个组件都由一对标签组成，有开始标签和结束标签，内容放置在开始标签和结束标签之间，内容也可以是组件。组件的语法格式如下:
<标签名 属性名=”属性值”>内容…</标签名>
组件通过属性来进一步细化。不同的组件可以有不同的属性，但它们也有一些共用属性，如id、class、style、hidden、data-*、bind */catch *等
1.id 组件的唯一表示，保持整个页面唯一，不常用
2. class 组件的样式类，对应 WXSS 中定义的样式
3. style 组件的内联样式，可以动态设置内联样式
4. hidden 组件是否显示，所有组件默认显示
5. data-*自定义属性，组件触发事件时，会发送给事件处理函数。事件处理函数可
以通过传人参数对象的 currentTarget,dataset 方式来获取自定义属性的值
6. bind*/catch* 组件的事件，绑定逻辑层相关事件处理函数
4.2 容器视图组件
容器视图组件是能容纳其他组件的组件，是构建小程序页面布局的基础组件，主要包括view、scroll-view和swiper 组件。
4.2.1 View
view组件是块级组件，没有特殊功能，主要用于布局展示，相当于HTML中的div，是布局中最基本的用户界面(User Interface，UI)组件，通过设置view的CSS属性可以实现各种复杂的布局。view组件的特有属性如表所示:
示例代码
<view style="text-align:center">默认 flex 布局</view>
<view style="display:flex">
<view style="border:lpx solid #f00;flex-grow:1" >1 </view>
<view style="border:1px solid #f00;flex-grow:1">2</view>
<view style="border:lpx solid #f00;flex-grow:1">3</view>
</view>
<view style="text-align:center">上下混合布局</view>
<view style="display:flex;flex-direction:column">
<view style="border:lpx solid #f00;">1 </view>
<view style="display:flex">
<view style="border:lpx solid #f00;flex-grow:1">2</view>
<view style="border:lpx solid #f00;flex-grow:2">3</view>
</view>
</view>
<view style="text-align:center">左右</view>
<view style="display:flex">
<view style="border:1px solid #f00;flex-grow:1">1</view>
<view style="display:flex;flex-direction:column;flex-grow:1">
<view style="border:1bx solid #f00;flex-grow:1">2</view>
<view style="border:1px solid #f00;flex-grow:2">3</view>
</view>
</view>
scroll-view
通过设置scroll-view组件的相关属性可以实现滚动视图的功能，其属性如图：
【注意】
（1）在使用坚向液动时，如果需要给scroll-view 组件设置一个固定高度，可以通过WXSS设置height来完成。
（2）请勿在 scroll-view 组件中使用textarea、map、canvas、video组件。
（3) scroll-into-view 属性的优先级高于scroll-top。
（4）由于在使用scroll-view 组件时会阻止页面回弹，所以在scroll-view 组件液动时无法触发onPullDownRefresh。
（5）如果要实现页面下拉刷新，请使用页面的滚动，而不是设置scroll-view组件。这样做，能通过单击顶部状态栏回到页面顶部。
示例代码
<view class="container" style="padding: 0rpx;">
<!-- 垂直滚动，这里必须设置高度 -->
<scroll-view scroll-top="{{scrollTop}}"scroll-y="true" style="height: {{scrollHeight}}px;" class="list" bind-scrolltolower="bindDownLoad" bindscrolltoupper="topLoad" bindscroll="scroll">
<view class="item" wx:for="{{list}}">
<image class="img" src="{{item.pic_url}}"></image>
<view class="text">
<text class="title">{{item.name}}</text>
<text class="description">{{item.short_description}}</text>
</view>
</view>
</scroll-view>
<view class="body-view">
<losding hidden="{{hidden}}" bindchange="loadingChange">
加载中……
</losding>
</view>
</view>
var url = "http://www.imooc.com/course/ajaxlist";
var page = 0;
var page_size = 5;
var sort = "last";
var is_easy = 0;
var lang_id = 0;
var pos_id = 0;
var unlearn = 0;
//请求数据
var losdMore = function(that){
that.setData({
hidden:false
});
wx.request({
url: 'url',
data:{
page:page,
page_size:page_size,
sort:sort,
is_easy:is_easy,
lang_id:lang_id,
pos_id:pos_id,
unlearn:unlearn
},
success:function(res){
var list = that.data.list;
for(var i=0;i<res.data.list.length;i++){
list.push(res.data.list[i]);
}
that.setData({
list:list
});
page++;
that.setData({
hidden:true
});
}
});
}
Page({
data:{
hidden:true,
list:[],
scrollTop:0,
scrollHeigt:0
},
onLoad:function(){
//这里要注意，微信的scroll-view必须设置高度才能监听滚动事件，所以需要在页面的onLoad事件中为scroll-view的高度赋值
var that = this;
wx.getSystemInfo({
success:function(res){
that.setData({
scrollHeigt:res.windowHeight
});
}
});
loadMore(that);
},
//页面滑动到底部
bindDownLoad:function(){
var that = this;
loadMore(that);
console.log("lower");
},
scroll:function(event){
//该方法绑定了页面滚动时的事件，这里记录了当前的position.y的值，为了在请求数据后把页面定位到这里
this.setData({
scrollTop:event.detail.scrollTop
});
},
topLoad:function(event){
//该方法绑定了页面滑动到顶部的时间，然后做页面上拉刷新
page = 0;
this.setData({
list:[],
scrollTop:0
});
loadMore(this);
console.log("lower");
}
}) .userinfo{
display: flex;
flex-direction: column;
align-items: center;
}
.userinfo-avatar{
width: 128rpx;
height: 128rpx;
margin: 20rpx;
border-radius: 50%;
}
.userinfo-nickname{
color:#aaa;
}
.usermotto{
margin-top: 200px;
}
scroll-view{
width: 100%;
}
.item{
width: 90%;
height: 300rpx;
margin: 20rpx auto;
background: brown;
overflow: hidden;
}
.item.img{
width: 430rpx;
margin-right: 20rpx;
float: left;
}
.title{
font-size: 30rpx;
display: block;
margin: 30rpx auto;
}
.description{
font-size: 26rpx;
line-height: 15rpx;
}swiper
swiper 组件可以实现轮播图、图片预览、滑动页面等效果。
一个完整的swiper组件由<swiper/>和<swiper -item/>两个标签组成，它们不能单独使用。<swiper/>中只能放置一个或多个<swipcr-item/>，若放置其他组件则会被删除；<swiper-item/>内部可以放置任何组件，默认宽高自动设置为100%。swiper组件的属性如图所示:
4.3基础内容组件
基础内容组件包括icon，text和progress，主要用于在视图页面中展示图标，文本和进度条等信息。
icon
icon组件即图标组件，通常用于表示一种状态，如success，info，warn，waiting，cancel等，其属性如图：
示例代码
<view>icon类型：
<block wx:for="{{iconType}}">
<icon type="{{item}}"/>{{item}}
</block>
</view>
<view>icon大小：
<block wx:for="{{iconSize}}">
<icon type="success" size="{{item}}"/>{{item}}
</block>
</view>
<view>icon颜色：
<block wx:for="{{iconColor}}">
<icon type="success" size="30" color="{{item}}"/>{{item}}
</block>
</view>
text
text 组件用于展示内容，类似HTML中的<span >，text 组件中的内容支持长按选中，支持转义字符“\”，属于行内元素。text组件的属性如表所示。
progress
progress 组件用于显示进度状态，如资源加载、用户资料完成度、媒体资源播放进度等progress 组件属于块级元素，其属性如表所示
4.4表单组件
表单组件的主要功能是收集用户信息，并将这些信息传递给后台服务器，实现小程序与用户之间的沟通。表单组件不仅可以放置在<form/>标签中使用，还可以作为单独组件和其他组件混合使用。
button
button 组件用来实现用户和应用之间的交互，同时按钮的颜色起引导作用。一般来说
在一个程序中一个按钮至少有3种状态:默认点击(default)、建议点击(primary)、谨慎点击(warn)。在构建项目时，应在合适的场景使用合适的按钮，当<buton>被<form/>包裹时，可以通过设置form-type 属性来触发表单对应的事件。buton组件的属性如表所示。
4.4.2 radio
单选框用来从一组选项中选取一个选项，在小程序中，单选框由<radio-group/>(单项选择器)和<radio/>(单选项目)两个组件组合而成，一个包含多个<radio/>的<radio-group/>表示一组单选项，在同一组单选项中<radio/>是互斥的，当一个按钮被选中后，之前选中的按钮就变为非选。它们的属性如图所示。
4.4.3 checkbox
复选框用于从一组选项中选取多个选项，小程序中复选框由<checkbox-group/>(多项选择器)和<checkbox>(多选项目)两个组件组合而成。一个<checkbox-group/>表示一组选项，可以在一组选项中选中多个选项。它们的属性如表所示。
4.4.4 switch
switch组件的作用类似开关选择器，其属性如表所示。
4.4.5 slider
slider 组件为滑动选择器,，可以通过滑动来设置相应的值，其属性如表所示。
4.4.6 picker
picker 组件为滚动选择器，当用户点击picker 组件时，系统从底部弹出选择器供用户选择。picker组件目前支持5种选择器，分别是:selector(普通选择器)、multiSelector(多列选择器)、time(时间选择器)、date(日期选择器)、region(省市选择器)
（1）普通选择器
普通选择器(mode=selector)的属性如表所示
2.多列选择器
多列选择器(mode=multiSelector)允许用户从不同列中选择不同的选择项，其选项是二维数组或数组对象。多列选择器的属性如表所示
3.时间选择器、日期选择器
时间选择器(mode=time)可以用于从提供的时间选项中选择相应的时间，其属性如表所示
4.省市选择器
省市选择器(mode=region)是小程序的新版本提供的选择快速地区的组件，其属性如表所示
picker-view
picker-view 组件为嵌入页面的滚动选择器。 相对于picker 组件, picker-view 组件的列的个数和列的内容由用户通过< picker-view -column/ > 自定义设置
input
input组件为输入框，用户可以输入相应的信息，其属性如表
textarea
textarea组件为多行输入框组件，可以实现多行内容的输入，属性如表:
label
label组件为标签组件, 用于提升表单组件的可用性。label 组件支持使用for属性找到对应的id,或者将控件放在该标签下, 当点击label 组件时,就会触发对应的控件。 for 属性的优先级高于内部控件, 内部有多个控件的时候默认触发第一个控件。 目前, label 组件可以绑定的控件有<button/ >、<checkbox/ >、<radio/ >、<switch/ >
form
form 组件为表单组件, 用来实现将组件内的用户输入信息进行提交。 当< form/ > 表单中formType为submit 的<button/ > 组件时, 会将表单组件中的value 值进行提交。其属性如表
多媒体组件
多媒体组件包括image (图像)、audio (音频)、video(视频)、camera (相机) 组件,使用这些组件, 可以让页面更具有吸引力
image
image 组件为图像组件, 与HTML中的< img/ > 类似, 系统默认image 组件的宽度为300px、高度为2250px，image组件的属性如表：
image组件中的mode 属性有１３ 种模式, 其中缩放模式有４ 种, 裁剪模式有９ 种
1.缩放模式
（1）scaleToFill
不保持纵横比缩放图片, 使图片的宽高完全拉伸至填满ｉｍａｇｅ 元素。
（2）aspectFit
保持纵横比缩放图片, 使图片的长边能完全显示出来。 也就是说, 可以将图片完整地显示出来。
（3）aspectFill
保持纵横比缩放图片, 只保证图片的短边能完全显示出来。 也就是说,图片通常只在水平或垂直方向是完整的, 在另一个方向将会发生截取。
（4）widthFix
宽度不变, 高度自动变化, 保持原图宽高比不变
2.剪裁模式
（1）top不缩放图片, 只显示图片的顶部区域。
（2） bottom不缩放图片, 只显示图片的底部区域。
（3） center不缩放图片, 只显示图片的中间区域。
（4）left不缩放图片, 只显示图片的左边区域。
（5） right不缩放图片, 只显示图片的右边区域。
（6）top-left不缩放图片, 只显示图片的左上边区域。
（7） top-right不缩放图片, 只显示图片的右上边区域。
（8）bottom-right不缩放图片, 只显示图片的左下边区域
audio
audio组件用来实现音乐播放、暂停等，属性如表
video
video组件用来实现视频的播放、暂停等。视频的默认宽度为300px, 高度为225px,video组件的属性如表所示
camera
camera 组件为系统相机组件, 可以实现拍照或录像功能。 在一个页面中, 只能有一camera 组件。 在开发工具中运行时, 使用电脑摄像头实现拍照或录像; 在手机中运行时, 使用手机前后摄像头实现拍照或录像
4.6其他组件
在小程序中，除了前面介绍的组件以外，map组件和canvas组件比较常用
map
map 组件用于在页面中显示地图或路径, 常用于ＬＢＳ (基于位置服务) 或路径指引, 功能相对百度地图、高德地图较简单, 目前具备绘制图标、路线、半径等能力, 不能在ｃｒｏｌｌ －ｖｉｅｗ、ｓｗｉｐｅｒ、ｐｉｃｋｅｒ － ｖｉｅｗ、ｍｏｖａｂｌｅ － ｖｉｅｗ 组件中使用。其属性如表
map组件的markers属性用于在地图上显示标记的位置，其相关属性如图
map组件的polyline 属性用来指定一系列坐标点, 从数组第一项连线到最后一项, 形成一条路线, 可以指定线的颜色、宽度、线型以及是否带箭头等, 其相关属性如图
canvas
canvas 组件用来绘制图形, 相当于一块无色透明的普通图布。 canvas 组件本身并没有绘图能力, 仅仅是图形容器, 通过绘图ＡＰＩ 实现绘图功能。同一页面中的ｃａｎｖａｓ － ｉｄ 不能重复, 否则会出错。属性如图
实现绘图需要３步:
（1）创建一个canvas 绘图上下文
（2）使用canvas绘图上下文进行绘图描述
（3）画图
第五章即速应用
5.1即速应用概述
即速应用是深圳市咫尺网络科技开发有限公司开发的一款同时兼具微信小程序和支付宝小程序快速开发能力的工具，用户只需简单拖拽可视化组件，就可以实现在线小程序开发据不完全统计，在微信小程序正式发布的1年内，在即速应用上打包代码并成功上线的微信小程序已经超过5万个
即速应用的功能特点主要体现在以下几个方面:
1.开发流程简单，零门槛制作
使用即速应用来开发微信小程序的过程非常简单，无须储备相关代码知识，没有开发经
验的人也可以轻松上手。(1)登录即速应用的官方网站(www.jisuapp.cn)，进入制作界面，从众多行业模板中选择一个合适的模板。
(2)在模板的基础上进行简单编辑和个性化制作
(3)制作完成后，将代码一键打包并下载。
(4)将代码上传至微信开发者工具。
(5)上传成功后，等待审核通过即可。
2.行业模板多样，种类齐全
即速应用为广大开发者提供了非常齐全的行业解决方案。目前，即速应用已经上线60多个小程序行业模板，涉及餐饮(单店版、多店版)、婚庆、旅游、运动、美容、房地产家居、医药、母婴、摄影、社区、酒店、KTV、汽车、资讯等多个行业。
这些小程序行业模板可以有效地帮助企业拓宽资源整合渠道，降低运营成本，提高管理效率。
3.丰富的功能组件和强大的管理后台
即速应用的功能组件和管理后台非常实用，可以根据实际情况解决商家的不同需求。例如，到店体系可以实现电子点餐、排队预约和线上快速结算;社区体系可以实现评论留言和话题管理;多商家系统可以实现分店统一管理、多门店统一运营;营销工具可以实现会员卡、优惠券的设置等营销方式……
目前，即速应用有4个版本，分别为基础版、高级版、尊享版和旗舰版。基础版为免费使用的版本，适合制作个人小程序，其他版本根据功能不同可以满足不同企业的需求。即速应用的应用范围主要包括以下类型:
（1）资讯类: 新闻、媒体
（2）电商类: 网购(服装、电器、读书、母婴………
（3）外卖类: 餐饮及零售
（4）到店类: 餐饮及酒吧
（5）预约类: 酒店、KTV、家教、家政，其他服务行业
即速应用界面介绍
登录即速应用官网、单击“注册”按钮，在如图所示的页面填写相应信息，即可完成注册。完成注册后，即可登录账号，使用即速应用
1.菜单栏
菜单栏中的“风格”选项用于设置小程序页面的风格颜色，“管理”选项用于进入后台管理页面，“帮助”选项用于提示帮助功能，“客服”选项用于进入客服界面，“历史’选项用来恢复前项操作，“预览”选项用在PC端预览制作效果，“保存”选项用于保存已制作的内容，“生成”选项用于实现小程序打包上线设置
2.工具栏
工具栏包括“页面管理”“组件库”2个选项卡，“页面管理”实现添加页面和添加分组以及对某一页面进行改名、收藏、复制、删除操作。“组件库”有9个基础组件、7个布局组件、18个高级组件和2个其他组件
3.编辑区
编辑区是用来制作小程序页面的主要区域，通过拖拽组件实现页面制作，右边的“前进”“后退”选项可以进行恢复操作，“模板”选项可以用来选择模板,“元素”选项可以用来显示页面中的组件及其层次关系，“数据”选项可以用来进行页面数据管理，“模块”选项可以用来选择模块
4.属性面板
属性面板用来设置选定组件的属性及样式，包括“组件”和“组件样式”两个选项卡“组件”选项卡用来设置组件内容及点击事件:“组件样式”选项卡用来设置组件的样式不同组件有不同的样式需要设置
5.2即速应用组件
即速应用提供了大量的组件供用户快速布局页面，包括7个布局组件、9个基本组件18个高级组件和2个其他组件
布局组件
布局组件用于设计页面布局，主要包括双栏、面板自由面板、顶部导航、底部导航、分割线和动态分类如图所示
（1）双栏组件
双栏组件用来布局整体，它可以把一个区块分为两部分，操作时显示一个分隔的标志，便于操作，预览时国则不会出现。双栏组件默认设置每个栏占50%总宽，也可以按实际需要调整比例。双栏里面可以添加基本的组件，从而达到整体的布局效果。双栏还可以嵌套双栏，即可以在其中的一个栏里嵌入一个双栏，从面将整体分成3部分(若需要将整体分成4部分，就再嵌套一个双栏，依次类推)。双栏组件的属性面板如图所示
（2）面板组件
面板组件相当于一个大画板，用户可以将很多基本(甚至高级)的组件(如文本组件图片组件、按钮组件，标题组件、分类组件、音组件、双栏组件、计数组件等)放进面板组件里一起管理。面板组件的属性面板如图所示
（3）自由面板组件
自由面板组件是指放置在该面板内的组件可以自由拖动，调节组件大小。用户既可以向自由面板内拖入部分组件(包括文本组件、图片组件和按钮组件)，也可以拖入任意相关容器组件，用于不规则布局。自由面板组件的属性面板如图所示
（4）分割线组件
分割线组件被放置于任意组件之间，用于实现分割分割线组件的属性面板如图所示
（5）弹窗组件
（6）滑动面板
（7）动态分类组件
动态分类组件仅适用于电商、到店类小程序。用户通过选择动态分类组件的样式，可以实现顶部分类、侧边栏分类来展示应用数据、商品数据等。动态分类的二级有图模式只适用于电商类小程序。动态分类组件的属性面板如图所示
（8）.分类导航
（9）侧边栏
（10）悬浮窗
（11）分类横滑
基本组件
基本组件是小程序页面常用的组件，包括文本、图片、按钮、标题、轮播、分类、图片列表、图文集和视频，如图所示
1.文本组件
文本组件用于展示文字、设置点击事件，是小程序页面中最常用的组件。文本组件的属性面板如图所示
2.图片组件
图片组件用于在页面中展示图片，其属性面板如图所示
3.按钮组件
按钮组件用于在页面中设置按钮，其属性面板如图所示
4.标题组件
标题组件用于在页面中设置标题，其属性面板如图所示
5.商品列表
6.视频
7.轮播组件
轮播组件用于实现图片的轮播展示，其属性面板如图所示
单击“添加轮播分组”按钮进人管理后台，然后单击“轮播管理”一“新建分组”选项可以创建轮播分组如图所示
8.公告
9.添加组合
高级组件
1动态列表组件
2个人中心组件
3动态表单组件
4评论组件
5计数组件
6地图组件
7城市定位组件
8悬浮窗组件
其他组件
1音频组件
2动态容器组件
5.3即速应用后台管理
数据管理
用户管理
分类管理
经营管理
多商家管理
5.4打包上传
第六章网络API
微信小程序处理的数据通常从后台服务器获取，再将处理过的结果保存到后台服务器这就要求微信小程序要有与后台进行交互的能力。微信原生API接口或第三方API提供了各类接口实现前后端交互。
网络API可以帮助开发者实现网络URL访问调用、文件的上传和下载、网络套接字的使用等功能处理。微信开发团队提供了10个网络API接口。
wx.request(Object)接口 用于发起HTTPS 请求。
wx.uploadFile(Object)接口用于将本地资源上传到后台服务器
wx.downloadFile(Object)接口 用于下载文件资源到本地。
wx.connectSocket(0bject)接口用于创建一个WebSocket 连接,
wx.sendSocketMessage(0bject)接口用于实现通过WebSocket 连接发送数据wx.closeSocket(0bject)接口 用于关闭 WebSocket 连接。
wx.onSocketOpen(CallBack)接口用于监听WebSocket 连接打开事件。
wx.onSocketError(CallBack)接口 用于监听 WebSocket 错误
wx.onSocketMessage(CallBack)接口用于实现监听WebSocket接收到服务器的消息
事件。
wx.onSocketClose(CallBack)接口用于实现监听WebSocket 关闭。
6.1.1 发起网络请求
wx.request(Object)实现向服务器发送请求、获取数据等各种网络交互操作，其相关参数如表6-1所示。一个微信小程序同时只能有5个网络请求连接，并且是HTTPS请求。
例如，通过wx. request（Object）获取百度（https://www.baidu.com）首页的数据。（需要在微信公众平台小程序服务器配置中的request合法域名中添加“https://www.baidu.com”。）
//.js
Page({
data:{
html:""
},
getbaidutap:function(){
var that = this;
wx.request({
url:'https://www.baidu.com',//百度网址
data:{},//发送数据为空
header:{'Content-Type':'application/json'},
success:function(res){
console.log(res);
that.setData({
html:res.data
})
}
})
}
})<button type="primary"bindtap ="getbaidutap">获取 HTML 数据</button>
<textarea value ='{{html}}'auto-heightmaxlength ='0'> </textarea>
例如，通过wx. request（Object）的GET方法获取邮政编码对应的地址信息。
示例代码如下：
//postcode.js
Page({
data:{
postcode:"",
address:[],//邮政编码对应的地址
errMsg:"",
error_code:-1//错误码
},
input:function(e){//输入事件
this.setData({
postcode:e.detail.value,
})
console.log(e.detail.value)
},
find:function(){//查询事件
var postcode =this.data.postcode;
if(postcode!=null&& postcode!=""){
var self =this;
//显示 toast 提示消息
wx.showToast({
title:'正在查询,请稍候....',
icon: 'loading',
duration:10000
});
wx.request({
url:'https://v.juhe.cn/postcode/query',
//第三方后台服务器
data :{
' postcode' :postcode,
'key':'0ff9bfccdf147476e067de994eb5496e'
},
header :{
'Content-Type ':'application/json',
},
method:'GET',//方法为GET
success:function(res){
wx.hideToast();//隐藏toast
if(res.data.error_code==0){
console.log(res);
self.setData({
errMsg:"",
error_code:res.data.error_code,//错误代码
address:res.data.result.list//获取到的数据
})
}
else{
self.setData({
errMsg:res.data.reasonllres.data.reason,//错误原因分析
error_code:res.data.error_code
})
}
}
})
}
}
})<view>邮政编码:</view >
<input type="text" bindinput="input" placeholder='6位邮政编码'/>
<button type="primary" bindtap="find">查询</button>
<block wx:for="{{address}}">
<block wx:for="{{item}}"><text>{{item}}</text></block>
</block >
6.1.2上传文件
wx. uploadFile（Object）接口用于将本地资源上传到开发者服务器，并在客户端发起一个HTTPS POST请求，其相关参数如表6-2所示。
wx. uploadFile（Object）相关参数：
通过wx. uploadFile（Object），可以将图片上传到服务器并显示。示例代码如下：
//upload.js
Page({
data:{
img :null,
uploadimage:function(){
var that =this;
//选择图片
wx.chooseImage({
success:function(res){
var tempFilePaths =res.tempFilePaths
upload(that,tempFilePaths);
}
})
function upload(page,path){
//显示toast提示消息
wx.showToast({
icon:"loading",
title:"正在上传"
}),
wx.uploadFile({
url:"http://localhost/",
filePath:path[0],
name:'file',
success:function(res){
console.log(res);
if(res.statusCodel=200){
wx.showModal({
title:'提示',
content:'上传失败',
showCancel:false
})
return;
}
var data =res.data
page.setData({ //上传成功修改显示头像
img:path[0]
})
},
fail:function(e){
console.log(e);
wx.showModal({
title:'提示',
content:'上传失败',
showCancel:false
})
},
complete:function(){//隐藏 Toast
wx.hideToast();
}
})
}
}
}
})
<button type="primary"bindtap="uploadimage">上传图片</button><image src="../images/小熊.jpg"mode="widthFix"/>
6.1.3下载文件
wx. downloadFile（Object）接口用于实现从开发者服务器下载文件资源到本地，在客户端直接发起一个HTTPGET请求，返回文件的本地临时路径。其相关参数如表6-3所示。
6.2多媒体API
多媒体API主要包括图片API、录音API、音频播放控制API、音乐播放控制API等，其目的是丰富小程序的页面功能。
6.2.1图片API
图片API实现对相机拍照图片或本地相册图片进行处理，主要包括以下4个API接口：
■ wx.chooseImage（Object）接口用于从本地相册选择图片或使用相机拍照。
■ wx.previewImage（Object）接口 用于预览图片。
■ wx.getImageInfo（Object）接口用于获取图片信息。
■ wx.saveImageToPhotosAlbum（Object）接口 用于保存图片到系统相册。
1．选择图片或拍照
wx. chooseImage（Object）接口用于从本地相册选择图片或使用相机拍照。拍照时产生的临时路径在小程序本次启动期间可以正常使用，若要持久保存，则需要调用wx. saveFile保存图片到本地。其相关参数如表6-4所示。
2．预览图片
wx. previewImage（Object）接口主要用于预览图片，其相关参数如表所示。
3．获取图片信息
wx. getImageInfo（Object）接口用于获取图片信息，其相关参数如表所示。
4．保存图片到系统相册
wx. saveImageToPhotosAlbum（Object）接口用于保存图片到系统相册，需要得到用户授权scope.writePhotosAlbum。其相关参数如表所示。
6.2.2录音API
录音API提供了语音录制的功能，主要包括以下两个API接口：
■ wx.startRecord（Object）接口用于实现开始录音。
■ wx.stopRecord（Object）接口
用于实现主动调用停止录音。
1．开始录音
wx. startRecord（Object）接口用于实现开始录音。当主动调用wx.stopRecord（Object）接口或者录音超过1分钟时，系统自动结束录音，并返回录音文件的临时文件路径。若要持久保存，则需要调用wx. saveFile（）接口。其相关参数如表6-8所示。
2．停止录音
wx. stopRecord（Object）接口用于实现主动调用停止录音。
wx.startRecord)
({
success: function(res){
var tempFilePath= res.tempFilePath},
fail: function(res){
//录音失败
}
})
setTimeout(function(){//结束录音
wx.stopRecord()
},10000)6.2.3 音频播放控制API
音频播放控制API主要用于对语音媒体文件的控制，包括播放、暂停、停止及audio组件的控制，主要包括以下3个API：
■ wx.playVoice（Object）接口 用于实现开始播放语音。
■ wx.pauseVoice（Object）接口用于实现暂停正在播放的语音。
■ wx.stopVoice（Object）接口 用于结束播放语音。
1．播放语音
wx. playVoice（Object）接口用于开始播放语音，同时只允许一个语音文件播放，如果前一个语音文件还未播放完，则中断前一个语音文件的播放。其相关参数如表6-9所示。
2．暂停播放
wx. pauseVoice（Object）用于暂停正在播放的语音。再次调用wx.playVoice（Object）播放同一个文件时，会从暂停处开始播放。如果想从头开始播放，则需要先调用wx.stopVoice（Object）。
示例代码如下：
wx.startRecord({
success: function(res){
var tempFilePath = res.tempFilePath
wx.playVoice({ filePath:tempFilePath
})
setTimeout(function(){
//暂停播放
wx.pauseVoice()},5000)
}
})3．结束播放
wx. stopVoice（Object）用于结束播放语音。
示例代码如下：
wx.startRecord({
success: function(res){
var tempFilePath =res.tempFilePath wx.playVoice({
filePath:tempFilePath})
setTimeout(function(){
wx.stopVoice()},5000)
}
})6.2.4 音乐播放控制API
音乐播放控制API主要用于实现对背景音乐的控制，音乐文件只能是网络流媒体，不能是本地音乐文件。音乐播放控制API主要包括以下8个API：
■ wx.playBackgroundAudio（Object）接口 用于播放音乐。
■ wx.getBackgroundAudioPlayerState（Object）接口 用于获取音乐播放状态。
■ wx.seekBackgroundAudio（Object）接口 用于定位音乐播放进度。
■ wx.pauseBackgroundAudio（）接口 用于实现暂停播放音乐。
■ wx.stopBackgroundAudio（）接口 用于实现停止播放音乐。
■ wx.onBackgroundAudioPlay（CallBack）接口 用于实现监听音乐播放。
■ wx.onBackgroundAudioPause（CallBack）接口 用于实现监听音乐暂停。
■ wx.onBackgroundAudioStop（CallBack）接口 用于实现监听音乐停止。
1．播放音乐
wx. playBackgroundAudio（Object）用于播放音乐，同一时间只能有一首音乐处于播放状态，其相关参数如表所示。
2.获取音乐播放状态
wx. getBackgroundAudioPlayerState(Object)接口用于获取音乐播放状态，其相关参数如表所示:
接口调用成功后返回的参数如表所示。
3．控制音乐播放进度
wx. seekBackgroundAudio（Object）接口用于控制音乐播放进度，其相关参数如表所示。
4．暂停播放音乐
wx. pauseBackgroundAudio（）接口用于暂停播放音乐。
示例代码如下：
wx.playBackgroundAudio{
dataUrl:' /usic /a. mp3'，
title:我的音乐，
coverImgUrl:/images/poster.jpg,success:function()
console.log(开始播放音乐了);
}
}）；
setTimeout(function(){
console.log('暂停播放');
wx.pauseBackgroundAudio();
1,5000):/5秒后自动暂停5.停止播放音乐
wx.shopBackgroundAudio()接口用于停止播放音乐。
wx.playBackgrondAudio{
dataUrl:'/music/a.mp3',
title:'我的音乐',
coverImgUrl:'/images/poster.jpg',
success:function(){
console.log('开始播放音乐了');
}
});
setTimeout(function(){
console.log('暂停播放');
wx.stopBackgroundAudio();
},5000);6．监听音乐播放
wx. onBackgroundAudioPlay（CallBack）接口用于实现监听音乐播放，通常被wx. playBack-groundAudio（Object）方法触发，在CallBack中可改变播放图标。
wx.playBackgroundAudio({
dataUrl:this.data.musicData.dataUrl,
title:this.data.musicData.title,
coverImgUrl:this.data.musicData.coverImgUrl.
success:function(){
wx.onBackgroundAudioStop(function(){
that.setData（{
isPlayingMusic:false
}）
}）7．监听音乐暂停
wx. onBackgroundAudioPause（CallBack）接口用于实现监听音乐暂停，通常被wx. pause-BackgroundAudio（）方法触发。在CallBack中可以改变播放图标。
8．监听音乐停止
wx. onBackgroundAudioStop（CallBack）接口用于实现监听音乐停止，通常被音乐自然播放停止或wx.seekBackgroundAudio（Object）方法导致播放位置等于音乐总时长时触发。在CallBack中可以改变播放图标。
9．案例展示
在此，以小程序music为案例来展示音乐API的使用。该小程序的4个页面文件分别为music. wxml、music.wxss、music. json和music. cojs。实际效果如图所示。
<view class="container">
<image class="bgaudio"src = "{{changedImg? music.coverImg:'../images/小熊.jpg'}}"/>
<view class ="control-view">
<!--使用data-how定义一个0表示快退10秒-->
<image src ="../images/小熊.jpg"bindtap="onPositionTap"data-how= "0 "/>
<image src = "../images/{{isPlaying?'paulse':'小熊'}}.jpg " bindtap = "onAudioTap"/>
<image src ="../images/小熊.jpg"bindtap = "onStopTap"/><!--使用data-how定义一个1表示快进10秒-->
<image src ="../images/小熊.jpg"bindtap ="onPositionTap"data-how = "1"/>
</view >
</view >.bgaudio{
height:350rpx; width:350rpx;
margin-bottom:100rpx;
}
.control-view image{
height:64rpx;
width:64rpx;
margin:30rpx;
}Page({
data:{
//记录播放状态
isPlaying:false,
//记录coverImg,仅当音乐初始时和播放停止时,使用默认的图片。播放中和暂停时，都使用当前音乐的图片
coverImgchangedImg:false,
//音乐内容
music:{
"url":"../images/e e.mp4",
"title":"盛晓玫-有一天",
"coverImg":
"../images/e e.mp4"
},
},
onLoad:function(){
//页面加载时,注册监听事件
this.onAudioState();
},
//点击播放或者暂停按钮时触发
onAudioTap:function(event){
if(this.data.isPlaying){
//如果在正常播放状态,就暂停,并修改播放的状态
wx.pauseBackgroundAudio();
}else{
//如果在暂停状态,就开始播放,并修改播放的状态28
let music = this.data.music;
wx.playBackgroundAudio({
dataUrl: music.url,
title: music.title,
coverImgUrl:music.coverImg
})
}
},
//点击即可停止播放音乐
onStopTap:function(){
let that = this;
wx.stopBackgroundAudio({
success:function(){
//改变coverImg和播放状态
that.setData({ isPlaying:false,changedImg:false});
}
})
},
//点击“快进10秒”或者“快退10秒”时,触发
onPositionTap:function(event){
let how = event.target.dataset.how;//获取音乐的播放状态
wx.getBackgroundAudioPlayerState({
success:function(res){
//仅在音乐播放中,快进和快退才生效
//音乐的播放状态,1表示播放中54
let status = res.status;
if(status === 1){//音乐的总时长
let duration = res.duration;//音乐播放的当前位置
let currentPosition = res.currentPosition;
if(how ==="0"){
//注意:快退时,当前播放位置快退10秒小于0时,直接设置position为1;否则,直接减去10秒//快退到达的位置
let position = currentPosition - 10;
if(position <0){
position =1;//执行快退
}
wx.seekBackgroundAudio({
position: position
});
//给出一个友情提示,在实际应用中,请删除!!!
wx. showToast({title:"快退10s",duration:500});
}
if(how === "1"){//注意:快进时,当前播放位置快进10秒后大于总时长时,直接设置position 为总时长减1
//快进到达的位置
let position =currentPosition +10;
if(position >duration){
position =duration-1;//执行快进
}
wx.seekBackgroundAudio({
position: position});//给出一个友情提示,在实际应用中,请删除!!!
wx.showToast({ title:"快进10s",duration:500});
}
}else { //给出一个友情提示,在实际应用中,请删除!!!
wx.showToast({title:"音乐未播放",duration:800});
}
}
})
},//音乐播放状态
onAudioState:function(){
let that =this;
wx.onBackgroundAudioPlay(function(){//当wx.playBackgroundAudio()执行时触发101 //改变coverImg和播放状态
that.setData({ isPlaying:true,changedImg:true});
console.log("on play");
});
wx.onBackgroundAudioPause(function(){ //当wx.pauseBackgroundAudio()执行时触发//仅改变播放状态
that.setData({isPlaying:false});
console.log("on pause");
});
wx.onBackgroundAudioStop(function(){ //当音乐自行播放结束时触发//改变coverImg和播放状态
that.setData({isPlaying:false,changedImg:false});
console.log("on stop");
});
}
}) {
"navigationBarBackgroundColor": "#000000",
"navigationBarTitleText": "音乐（林）",
"navigationBarTextStyle": "white",
"backgroundTextStyle": "dark"
}运行效果
6.3文件API
从网络上下载或录音的文件都是临时保存的，若要持久保存，需要用到文件API。文件API提供了打开、保存、删除等操作本地文件的能力，主要包括以下5个API接口：
■ wx.saveFile（Object）接口 用于保存文件到本地。
■ wx.getSavedFileList（Object）接口 用于获取本地已保存的文件列表。
■ wx.getSaveFileInfo（Object）接口 用于获取本地文件的文件信息。
■ wx.removeSaveFile（Object）接口 用于删除本地存储的文件。
■ wx.openDocument（Object）接口 用于新开页面打开文档，支持格式：doc、xls、ppt、pdf、docx、xlsx、ppts。
1．保存文件
wx. saveFile（Object）用于保存文件到本地，其相关参数如表所示。
2．获取本地文件列表
wx. getSavedFileList（Object）接口用于获取本地已保存的文件列表，如果调用成功，则返回文件的本地路径、文件大小和文件保存时的时间戳（从1970/01/01 08: 00: 00到当前时间的秒数）文件列表。其相关参数如表所示。
3．获取本地文件的文件信息
wx. getSaveFileInfo（Object）接口用于获取本地文件的文件信息，此接口只能用于获取已保存到本地的文件，若需要获取临时文件信息，则使用wx. getFileInfo（Object）接口。其相关参数如表所示。
4．删除本地文件
wx. removeSaveFile（Object）接口用于删除本地存储的文件，其相关参数如表6-17所示。
5.打开文档
wx.openDocument(Object)接口用于新开页面打开文档，支持格式有doc、xls、ppt、pdf、docx、pptx,相关参数如表所示：
6.4本地数据及缓存API
小程序提供了以键值对的形式进行本地数据缓存功能，并且是永久存储的，但最大不超过10MB，其目的是提高加载速度。数据缓存的接口主要有4个:
wx.setStorage(Object)或wx.setStorageSync(key,data)接口 用于设置缓存数据 wx.getStorage(Object)或wx.getStorageSync(key)接口 用于获取缓存数据。wx.removeStorage(Object)或wx.removeStorageSync(key)接口 用于删除指定缓存数据。
wx.clearStorage()或wx.clearStorageSync()接口用于清除缓存数据其中，带 Sync 后缀的为同步接口，不带Sync后缀的为异步接口。
6.4.1保存数据
1. wx. setStorage( Object)
wx.setStorage(0bject)接口将数据存储到本地缓存接口指定的key中，接口执行后会覆盖原来key对应的内容。其参数如表所示
6.4.2获取数据
1.wx.getStorage(Object)
wx.getStorage(Object)接口是从本地缓存中异步获取指定key对应内容。其相关参数如表所示。
wx.getstorage({ key:'name',
success:function(res){
console.log(res.data)
},
})2.wx. getStorageSync( key)
wx.gelStorageSyne(key)从本地缓存中同步获取指定key 对应的内容。其参数只有key
//获取数据 同步 js文件
try{
var value=wx.getStorageSync('age')
if(value){
console.log("获取成功"+value)
}
}catch(e){
console.log("获取失败")
}6.4.3删除数据
1. wx. removeStorage( Object )
wx.removeStorage(0bject)接口用于从本地缓存中异步移除指定key。其相关参数如表所示
//删除数据 异步 js文件
wx.removeStorage({
key: 'name',
success:function(res){
console.log("删除成功")
},
fail:function(){
console.log("删除失败")
}
})2.wx.removeSlorageSyne( key )
wx.removeStorageSyne(key)接口用于从本地缓存中同步删除指定key对应的内容。其参数只有key
//删除数据 同步 js文件
try{
wx.removeStorageSync('name')
}catch(e){
//Do something when catch error
},6.4.4清空数据
1.wx.clearStorage( )
wx.clearStorage()接口用于异步清理本地数据缓存，没有参数。示例代码如下:
//清空数据 异步 js文件
wx.getStorage({
key:'name',
success:function(res){
//清理本地数据缓存
wx.clearStorage()
}
})2.wx.clearStroageSyne( )
wx.clearStroageSyne()接口用于同步清理本地数据缓存。示例代码如下:
//清空数据 同步 js文件
try{
wx.clearStorageSync()
}catch(e){}6.5位置信息API
小程序可以通过位置信息API来获取或显示本地位置信息，小程序支持WGS84和GCj02标准，WGS84标准为地球坐标系，是国际上通用的坐标系；GCj02标准是中国国家测绘局制定的地理信息系统的坐标系统，是由WGS84坐标系经加密后的坐标系，又称为火星坐标系。默认为WGS84标准，若要查看位置需要使用GCj02标准。主要包括以下3个API接口：
■ wx.getLocation（Object）接口用于获取位置信息。
■ wx.chooseLocation（Object）接口 用于选择位置信息。
■ wx.openLocation（Object）接口用于通过地图显示位置。
6.5.1获取位置信息
wx. getLocation（Object）接口用于获取当前用户的地理位置、速度，需要用户开启定位功能，当用户离开小程序后，无法获取当前的地理位置及速度，当用户点击“显示在聊天顶部”时，可以获取到定位信息，其相关参数如表所示。
wx. getLocation（Object）调试成功后，返回的参数如表所示。
wx.getLocation({
type:'wgs84',
success:function(res){
console.log("经度:"+res.longitude); console.log("纬度:"+res.latitude); console.log("速度:"+res.longitude);
console.log("位置的精确度:"+res.accuracy);
console.log("水平精确度:"+res.horizontalAccuracy); console.log("垂直精确度:"+res.verticalAccuracy);},
})6.5.2选择位置信息
wx. chooseLocation（Object）接口用于在打开的地图中选择位置，用户选择位置后可返回当前位置的名称、地址、经纬度信息。其相关参数如表所示。
wx. chooseLocation（Object）调用成功后，返回的参数如表所示。
wx.getLocation({
type:'gcj02',//返回可以用于wx.openLocation的经纬度
success:function(res){
var latitude = res.latitude
var longitude= res.longitude
wx.openLocation({
latitude: latitude,
longitude:longitude,
scale:10,
name:'智慧国际酒店',
address:'西安市长安区西长安区300号'})
}
})6.5.3显示位置信息
wx.openLqcation(Object)接口用于在微信内置地图中显示位置信息，起相关参数如表所示。
wx.getLocation({
type:gcj02',/返回可以用于wx.openLocation的经纬度
success:function(res){
var latitude =res.latitude
var longitude =res.longitude
wx.openLocation({
latitude:latitude,
longitude:longitude,
scale:10,
name:'智慧国际酒店',
address:'西安市长安区西长安区300号'
})
}
})6.6设备相关API
设备相关的接口用于获取设备相关信息，主要包括系统信息、网络状态、拨打电话及扫码等。主要包括以下5个接口API：
■ wx.getSystemInfo（Object）接口、wx.getSystemInfoSync（）接口 用于获取系统信息。
■ wx.getNetworkType（Object）接口 用于获取网络类型。
■ wx.onNetworkStatusChange（CallBack）接口 用于监测网络状态改变。
■ wx.makePhoneCall（Object）接口 用于拨打电话。
■ wx.scanCode（Object）接口 用于扫描二维码
6.6.1获取系统信息
wx. getSystemInfo（Object）接口、wx. getSystemInfoSync（）接口分别用于异步和同步获取系统信息。其相关参数如表6-27所示。
wx. getSystemInfo（）接口或wx.getSystemInfoSync（）接口调用成功后，返回系统相关信息，如表所示。
wx.getSystemInfo({
success:function(res){
console.log("手机型号:"+res.model)
console.log("设备像素比:"+res.pixelRatio)
console.log("窗口的宽度:"+ res.windowWidth)
console.log("窗口的高度:"+res.windowHeight)
console.log("微信的版本号:"+res.version)
console.log("操作系统版本:"+ res.system)
console.log("客户端平台:"+res.platform)},})
6.6.2网络状态
1．获取网络状态
wx. getNetworkType（Object）用于获取网络类型，其相关参数如表6-29所示。
如果wx. getNetworkType（）接口被成功调用，则返回网络类型包，有wifi、2G、3G、4G、unknown（Android下不常见的网络类型）、none（无网络）。
示例代码如下：
wx.getNetworkType({
success:function(res){
console.log(res.networkType)},})2．监听网络状态变化
wx. onNetworkStatusChange（CallBack）接口用于监听网络状态变化，当网络状态变化时，返回当前网络状态类型及是否有网络连接。
示例代码如下:
wx.onNetworkStatusChange(function(res){
console.log("网络是否连接:"+res.isConnected)
console.log("变化后的网络类型"+res.networkType)})6.6.3拨打电话
wx. makePhoneCall（Object）接口用于实现调用手机拨打电话，其相关参数如表6-30所示。
wx.makePhoneCall({
phoneNumber:'18092585093'//需要拨打的电话号码
})6.6.4扫描二维码
wx. scanCode（Object）接口用于调起客户端扫码界面，扫码成功后返回相应的内容，其相关参数如表6-31所示。
扫码成功后，返回的数据如表6-32所示。
//允许从相机和相册扫码
wx.scanCode({
success:(res) =>{
console.log(res.result)
console.log(res.scanType)
console.log(res.charSet)
console.log(res.path)
}
})
//只允许从相机扫码
wx.scanCode({
onlyFromCamera:true,
success:(res) =>{
console.log(res)
}
})
185
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
