一到六章总结-CSDN博客

本文链接：https://blog.csdn.net/2301_76548105/article/details/138245479

第一章总结、

1.1 小程序简介
微信（WeChat）是由腾讯公司于2011年1月21日推出的一款为智能终端提供即时通信（Instant Messaging , M）服务的应用程序。

小程序、订阅号、服务号、企业微信（企业号）属于微信公众平台的四大生态体系，它们面向不同的用户群体。

1.2 小程序特征
小程序嵌入微信之中，不需要下载安装外部应用，用户通过扫描二维码和搜索相关功能的关键词即可使用，具备无需安装、触手可及、用完即走、无需卸载的特性。

1.3 小程序应用场景的特点
(1) 简单的业务逻辑
简单是指应用本身的业务逻辑并不复杂。例如，出行类应用 “ofo小黄车” ，用户通过扫描二维码就可以实现租车，该应用的业务逻辑非常简单，服务时间短暂，“扫完即走”。不过，对于业务复杂的应用，无论是从功能实现上还是从用户体验上，小程序都不如原生APP。

(2) 低频度的使用场景
低频度是小程序使用场景的另一个特点。例如，提供在线购买电影票服务的小程序应用 “猫眼”，用户对该小程序的使用频度不是很高，就没有必要在手机上安装一个单独功能的APP。

如果某种应用的使用频度很高，则以原生APP的方式提供给用户服务效果更好。

2.1 微信小程序开发流程
第一步，在微信公众平台上注册小程序账号。

第二步，下载开发者工具进行编码。

第三步，通过开发者工具提交代码，待通过审核后便可以发布。

2.2 微信小程序开发者工具界面功能介绍

1.工具栏
可以实现多种功能，例如账号的切换等。

2.模拟区
在模拟区中选择模拟手机的类型、显示比例、网络类型后，模拟器中会显示小程序的运行效果。

3.目录文件区
目录文件区用来显示当前项目的目录结构，单击左上角的 “+” 按钮可以进行目录和文件的创建，右键单击目录文件区的文件或目录可以进行 “硬盘打开” “重命名” “删除”等相关操作。

4.编辑区
编辑区用来实现对代码的编辑操作，编辑区中支持对 .wxml、.wxss、.js及.json文件的操作，使用组合键能提高代码的编辑效率。

5.调试区
调试区的功能是帮助开发者进行代码调试及进行排查有问题的区域

3.0 第一个微信小程序项目
// index.js
const defaultAvatarUrl = 'https://mmbiz.qpic.cn/mmbiz/icTdbqWNOwNRna42FI242Lcia07jQodd2FJGIYQfG0LAJGFxM4FbnQP6yfMxBgJ0F3YRqJCJ1aPAK2dQagdusBZg/0'

Page({
data: {
motto: 'Hello World',
userInfo: {
avatarUrl: defaultAvatarUrl,
nickName: '',
},
hasUserInfo: false,
canIUseGetUserProfile: wx.canIUse('getUserProfile'),
canIUseNicknameComp: wx.canIUse('input.type.nickname'),
},
bindViewTap() {
wx.navigateTo({
url: '../logs/logs'
})
},
onChooseAvatar(e) {
const { avatarUrl } = e.detail
const { nickName } = this.data.userInfo
this.setData({
"userInfo.avatarUrl": avatarUrl,
hasUserInfo: nickName && avatarUrl && avatarUrl !== defaultAvatarUrl,
})
},
onInputChange(e) {
const nickName = e.detail.value
const { avatarUrl } = this.data.userInfo
this.setData({
"userInfo.nickName": nickName,
hasUserInfo: nickName && avatarUrl && avatarUrl !== defaultAvatarUrl,
})
},
getUserProfile(e) {
// 推荐使用wx.getUserProfile获取用户信息，开发者每次通过该接口获取用户个人信息均需用户确认，开发者妥善保管用户快速填写的头像昵称，避免重复弹窗
wx.getUserProfile({
desc: '展示用户信息', // 声明获取用户个人信息后的用途，后续会展示在弹窗中，请谨慎填写
success: (res) => {
console.log(res)
this.setData({
userInfo: res.userInfo,
hasUserInfo: true
})
}
})
},
})

<scroll-view class="scrollarea" scroll-y type="list">
<view class="container">
<view class="userinfo">
<block wx:if="{{canIUseNicknameComp && !hasUserInfo}}">
<button class="avatar-wrapper" open-type="chooseAvatar" bind:chooseavatar="onChooseAvatar">
<image class="avatar" src="{{userInfo.avatarUrl}}"></image>
</button>
<view class="nickname-wrapper">
<text class="nickname-label">昵称</text>
<input type="nickname" class="nickname-input" placeholder="请输入昵称" bind:change="onInputChange" />
</view>
</block>
<block wx:elif="{{!hasUserInfo}}">
<button wx:if="{{canIUseGetUserProfile}}" bindtap="getUserProfile"> 获取头像昵称 </button>
<view wx:else> 请使用2.10.4及以上版本基础库 </view>
</block>
<block wx:else>
<image bindtap="bindViewTap" class="userinfo-avatar" src="{{userInfo.avatarUrl}}" mode="cover"></image>
<text class="userinfo-nickname">{{userInfo.nickName}}</text>
</block>
</view>
<view class="usermotto">
<text class="user-motto">{{motto}}</text>
</view>
</view>
</scroll-view>

第二章总结

2.1 小程序的基本目录结构
1.基本目录结构

项目主目录下有2个子目录(pages和utils)和4个文件(app.js、app.jsonapp.wxss 和project. config. json )。

在主目录中，3个以“app”开头的文件是微信小程序框架的主描述文件，是应用程序级别的文件。这3个文件不属于任何页面。

project. confg.json 文件是项目配置文件，包含项目名称、AppID等相关信息.

2.主体文件
微信小程序的主体部分由3个文件组成，这3个文件必须放在项目的主目录中，负责小程序的整体配置，它们的名称是固定的。

app.js 小程序逻辑文件，主要用来注册小程序全局实例。在编译时，app.js文件会和其他页面的逻辑文件打包成一个JavaScript文件。该文件在项目中不可缺少。

app.json 小程序公共设置文件，配置小程序全局设置。该文件在项目中不可缺少

app.wxss 小程序主样式表文件，类似HTML的.css文件。在主样式表文件中设置的样式在其他页面文件中同样有效。该文件在项目中不是必需的。

3.页面文件
.js文件页面逻辑文件，在该文件中编写Javaserpt代码控制页面的逻辑。该文件在每个小程序的页面中不可缺少。

.wxml文件页面结构文件，用于设计页面的布局、数据定等。

.wxss文件，页面样式表文件，用于定义本页面中用到的各类样式表。当页面中有样式表文件时，文件中的样式规则会层叠覆盖app.wxss中的样式规则;否则，直接使用app.wxss 中指定的样式规则。

.json文件，页面配置文件。该文件在页面中不可缺少。

2.2 小程序的开发框架
1.小程序框架示意图

2.视图层
MINA框架的视图层由WXML与WXSS编写，由组件来进行展示。对于微信小程序而视图层就是所有、wxml文件与.wxss文件的集合:.wxml文件用于描述页面的结构;音，wxss 文件用于描述页面的样式。

3.逻辑层
逻辑层用于处理事务逻辑。对于微信小程序而言，逻辑层就是所有,j脚本文件的集合徽信小程序在逻辑层将数据进行处理后发送给视图层，同时接受视图层的事件反馈。

4.数据层
数据层在逻辑上包括页面临时数据或缓存、文件存储(本地存储)和网络存储与调用。

2.3 创建小程序页面
1.创建第一个页面文件
继续在项目主目录下新建一个pages目录，在pmges日录下新建一个news目录，并在news目录下新建news.js、news. json、news.wxml 和news.wxss空文件。

首先打开news.wxml文件，随便输入一行字,然后告诉系统这个文件的名称和路径，打开配置文件app.json,输入以下代码:

"pages": [
"pages/news/news",
"pages/logs/logs"
],
接下来打开news.json文件输入一对空“{}”即可,随即打开news.js文件输入以下代码：

Page({

})
保存后编译，在模拟器中即可运行成功。

2.4 配置文件
1. 全局配置文件

2. pages配置项
pages配置项接受一个数组，用来指定小程序由哪些页面组成，数组的每一项都是字符
串，代表对应页面的“路径”+“文件名”。

3.window 配置项
window 配置项负责设置小程序状态栏、导航条、标题、窗口背景色等系统样式。window配置项可以配置的对象参考表

4.tabBar 配置项
当需要在程序顶部或底部设置菜单栏时，可以通过配置tabBar配置项来实现。

tabBar中list(列表)接受数组值，数组中的每一项也是一个对象。

5.networkTimeout配置项
小程序中各种网络请求 API的超时时间值只能通过networkTimeout 配置项进行统一设置、能在 API中单独设置。

6.运行代码：
app.json:

{
"pages": [
"pages/news/news",
"pages/logs/logs"
],
"window": {
"navigationBarBackgroundColor": "#fff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "小程序windou功能演示",
"backgroundColor": "#ccc",
"backgroundTextStyle":"light"
},
"tabBar": {
"color": "#666666",
"selectedColor": "#ff0000",
"borderStyle":"black",
"backgroundColor": "#ffffff",
"list": [
{
"pagePath": "pages/logs/logs",
"iconPath": "components/img/1.png",
"selectedIconPath": "components/img/1.png",
"text": "首页"
},
{
"pagePath": "pages/news/news",
"iconPath": "components/img/2.jpg",
"selectedIconPath": "components/img/2.jpg",
"text": "新闻"
}
]
},
"style": "v2",
"renderer": "skyline",
"rendererOptions": {
"skyline": {
"defaultDisplayBlock": true,
"disableABTest": true,
"sdkVersionBegin": "3.0.0",
"sdkVersionEnd": "15.255.255"
}
},
"componentFramework": "glass-easel",
"sitemapLocation": "sitemap.json",
"lazyCodeLoading": "requiredComponents"
}

运行结果：

2.5逻辑层文件

当启动小程序时，首先会依次触发生命周期函数onLanuch和onShow方法，然后通过app.json的 pages属性注册相应的页面，最后根据默认路径加载首页

1.app.js配置文件
App({
onlaunch(){
console.log("小程序初始化");
},
onShow(){
console.log("小程序启动");
},
onHde(){
console.log('小程序隐藏');
}
})
2.页面逻辑文件
页面逻辑文件的主要功能有:设置初始数据:定义当前页面的生命周期函数;定义事件处理函数等。

3.news.js
//页面的初始数据
data:{
name:"lwk",//字符串
age:30,//数字
birthday:[{ year:1988 },{ month:11 },{ data:18 }],//数组
object:{hobby:'computer'},//对象
4.news.wxml
<view>姓名 : {{name}}</view>
<view>年龄 : {{age}}</view>
<view>出生日期 :
{{birthbay[0].year}}年
{{birthbay[1].month}}月
{{birthbay[2].bate}}日
</view>
<view>爱好 : {{object.hobby}}</view>
5.运行结果

6.定义事件处理函数
开发者在 Page()中自定义的函数称为事件处理函数。视图层可以在组件中加人事件缃定，当达到触发事件时，小程序就会执行Page()中定义的事件处理函数.

7.使用setDate更新数据
小程序在 Page 对象中封装了一个名为setData()的函数，用来更新data中的数据数参数为 0bject，以“key:value”对的形式表示将 this.data中的 key 对应的值修改为 value.

2.6 页面结构文件
页面结构文件(WXML)是框架设计的一套类似HTML的标签语言，结合基础组件、事件系统，可以构建出页面的结构，即.wxm 文件。在小程序中，类似HTML 的标签被称为组件，是页面结构文件的基本组成单元。这些组件有开始(如<view>)和结束(如</vew>)标志，每个组件可以设置不同的属性(如id、class 等)，组件还可以嵌套。
WXML还具有数据绑定、条件数据绑定、列表数据绑定、模板、引用页面文件、页面事件等能力。

1.数据绑定
简单绑定作用于组件属性、控制属性时，双大括号外应添加双引号。

示例代码:

news.wxml
<view wx:for="{{students}}">
<text> 姓名：{{item.nickname}}</text>
<text> 身高：{{item.height}}</text>
<text> 体重：{{item.weight}}</text>
nwqa.js
students:[
{nickname:'Tom',height:180,weight:140},
{nickname:'Anne',height:180,weight:140}
2.运算
<view>算数运算:{{age + num}}</view>
<view>逻辑运算{{age==40}}</view>
<view>三元运算{{age==40 ?'happy' : 'nohappy'}}</view>
3.条件数据绑定
<view wx:if="age>40">1</view>
<view wx:elif="age==40">0</view>
<view wx:else>-1</view>
4.列表数据绑定
<view wx:for = "{{items}}">
{{index}}:{{inem}}
</view>
5.模板与引用页面文件
<template name="stu">
<block wx:for="{{students}}">
<view wx:for="{{students}}">
<text> 姓名：{{item.nickname}}</text>
<text> 身高：{{item.height}}</text>
<text> 体重：{{item.weight}}</text>
</view>
</block>
</template>
<template is="stu" data="{{students}}"></template>
6.运行结果

7 页面事件
简单来说，小程序中的事件是用户的一种行为或通信方式。在页面文件中，通过定义事件来完成页面与用户之间的交互，同时通过事件来实现视图层与逻辑层的通信。我们可以将事件绑定到组件上，当达到触发条件时，事件就会执行逻辑层中对应的事件处理函数。
要实现这种机制，需要定义事件函数和调用事件。

在小程序中分为冒泡事件和非冒泡事件两大类型

冒泡事件冒泡事件是指某个组件上的事件被触发后，事件会向父级元素传递，父级元素再向其父级元素传递，一直到页面的顶级元素。
非冒泡事件非冒泡事件是指某个组件上的事件被触发后，该事件不会向父节点传递

8.页面样式文件
页面样式文件(wXSS)是基于CSS拓展的样式语言，用于描述WXML的组成样式，决定WXML的组件如何显示。WxsS具有CSs的大部分特性，小程序对 WXSS 做了一些扩充和修改。

尺寸单位：由于 CSS 原有的尺寸单位在不同尺寸的屏幕中得不到很好的呈现，WXSS 在此基础上增加了尺寸单位rpx(respnesive pixel)。wXss规定屏幕宽度为750px，在系统数据绑定过程中rpx会按比例转化为px

样式导入：为了方便管理WXSS文件，我们可以将样式存放在不同的文件中。例如：

.con{border:1px solid #f00;
padding:5px;margin:5px;}
选择器：目前，WXSS 仅支持 CSS 中常用的选择器，如.class、#id、element、::before、:aftert 等

WXSS 常用属性
WXSS文件与CSS文件有大部分属性名及属性值相同，WXSS的常用属性及属性值

2.8 本章小结

本章首先讲解了小程序的目录结构，然后通过目录结构介绍了小程序的框架，最后主要介绍了小程序文件的类型及其配置。这些知识都是开发微信小程序的基础知识，大家必须深刻理解和熟练掌握，并勤写代码多加练习，为后续的学习打下扎实的基础。

第三章总结

3.1盒子模型
3.1.1盒子模型结构

在页面设计中，只有掌握了盒子模型以及盒子模型的各个属性和应用方法，才能轻松控制页面中的各个元素。

盒子模型就是我们在页面设计中经常用到的一种思维模型。在CSS中，一个独立的盒子模型由内容(content)、内边距(padding)、边框(border)和外边距(margin)4个部分组成

此外，对 padding、border 和 margin 可以进一步细化为上、下、左、右4个部分,在 CSS中可以分别进行设置，如图所示。

3.1.2 图中各元素的含义
width和height 内容的宽度和高度

padding -top、padding -right、padding-bottom和 padding-left 上内边距、右内边边距、底内边距和左内边距

border -top、bonder -right、border -bottom和 border -left 上边框、右边框、底边框和左边框

margin-top、margin-right、margin-bottom和margin-left 上外边距、右外边距，地外边距和左外边距

因此，一个盒子实际所占有的宽度（高度）应该由“内容+内边距+边框+外边距”组成

3.2块级元素与行内元素
3.2.1 块级元素

块级元素默认占一行高度，一行内通常只有一个块级元素(浮动后除外)，添加新的块级元素时，会自动换行，块级元素一般作为盒子出现。块级元素的特点如下:
(1)一个块级元素占一行。
(2)块级元素的默认高度由内容决定，除非自定义高度。
(3)块级元素的默认宽度是父级元素的内容区宽度，除非自定义宽度:
(4)块级元素的宽度、高度、外边距及内边距都可以自定义设置。
(5)块级元素可以容纳块级元素和行内元素。
<view/>组件默认为块级元素，使用<view/>组件演示盒子模型及块级元素的示例代码如下:

<view style="border: 1px solid #f00;">块级元素</view>

<view style="border: 1px solid #0f0;margin: 15px;padding: 20px;">块级元素2</view>

<view style="border: 1px solid #00f;width: 200px;height: 80px;">块级元素3</view>

<view style="border: 1px solid #ccc;"></view>
<view style="height: 60px;">块级元素4</view>

<view style="border: 1px solid #f00;width: 100px;background-color: #ccc;">父级元素高度随内容决定，内容为文本</view>
运行结果

3.2.2行内元素
行内元素，不必从新一行开始，通常会与前后的其他行内元素显示在同一行中，它们不占有独立的区域，仅靠自身内容支撑结构，一般不可以设置大小，常用于控制页面中文本的样式。将一个元素的 display属性设置为inline后，该元素即被设置为行内元素。行内元素的特点如下:
(1)行内元素不能被设置高度和宽度，其高度和宽度由内容决定

(2)行内元素内不能放置块级元素，只级容纳文本或其他行内元素。

(3)同一块内，行内元素和其他行内元素显示在同一行。<texV>组件默认为行内元素，使用<view/>及<texV>组件演示盒子模型及行内元素的示例代码如下:

<view style="padding: 20px;">
<text style="border: 1px solid #f00;">文本1</text>
<text style="border: 1px solid #0f0;margin: 10px;padding: 5px;">文本2</text>
<view style="border: 1px solid #f00;display: inline;">块级元素设置为行内元素</view>一行显示不全，自动换行显示
</view>

<view>
元素显示方式的<view style="display: inline-block;border: 1px solid #f00;margin: 10px;padding: 10px;width: 200px;">块级元素、行内元素和行内块元素</view>三种类型
运行结果

3.3浮动与定位
3.3.1元素浮动与清除
元素浮动就是指设置了浮动属性的元素会脱离标准文档流的控制，移到其父元素中指定位置的过程。在CSS中，通过foat属性来定义浮动，其基本格式如下：
{float:none lleft lright;}
其中，none--默认值，表示元素不浮动;
left--元素向左浮动;
night--元素向右浮动。
在下面的示例代码中，分别对box1、box2、box3元素左浮动:

<view>box1,box2,box3 没浮动</view>
<view style="border: 1px solid #f00;padding: 5px;">
<view style="border: 1px solid #0f0;">box1</view>
<view style="border: 1px solid #0f0;">box2</view>
<view style="border: 1px solid #0f0;">box3</view>
</view>
<view>box1 左浮动</view>
<view style="border: 1px solid #f00;padding: 5px;">
<view style="float: left;border: 1px solid #0f0;">box1</view>
<view style="border: 1px solid #0f0;">box2</view>
<view style="border: 1px solid #0f0;">box3</view>
</view>
<view>box1 box2 左浮动</view>
<view style="border: 1px solid #f00;padding: 5px;">
<view style="float: left;border: 1px solid #0f0;">box1</view>
<view style="float: left;border: 1px solid #0f0;">box2</view>
<view style="border: 1px solid #0f0;">box3</view>
</view>
<view>box1 box2 box3 左浮动</view>
<view style="border: 1px solid #f00;padding: 5px;"></view>
<view style="float: left;border: 1px solid #0f0;">box1</view>
<view style="float: left;border: 1px solid #0f0;">box2</view>
<view style="float: left;border: 1px solid #0f0;">box3</view>

运行结果：

通过案例我们发现，当box3左浮动后，父元素的边框未能包裹box3元素。这时，可以通过清除浮动来解决。
由于浮动元素不再占用原文档流的位置，因此它会对页面中其他元素的排列产生影响在CSS中，clear属性用于清除浮动元素对其他元素的影响，其基本格式如下
clear:left lright lboth Inone
其中，lef--清除左边浮动的影响，也就是不允许左侧有浮动元素nght--清除右边浮动的影响，也就是不允许右侧有浮动元素:
both--同时清除左右两侧浮动的影响;
none--不清除浮动

示例代码：

<view>box1 box2 左浮动 box3 清除左浮动</view>
<view style="border: 1px solid #f00;padding: 5px;">
<view style="float: left;border: 1px solid #0f0;">box1</view>
<view style="float: left;border: 1px solid #0f0;">box2</view>
<view style="clear: left;border: 1px solid #0f0;">box3</view>
</view>
运行结果：

此外，还可以在父类元素外添加一个空元素，实现父元素包裹浮动元素。示例代码如下;

<view>box1 box2 box3 左浮动在父元素后添加一个空元素</view>
<view style="border: 1px solid #f00;padding: 5px;" class="clear-float">
<view style="float: left;border: 1px solid #0f0;">box1</view>
<view style="float: left;border: 1px solid #0f0;">box2</view>
<view style="float: left;border: 1px solid #0f0;">box3</view>
</view>
.clear float::after{display:block;clear:both;height: 0;content:"";}
运行结果：

3.3.2元素定位
浮动布局虽然灵活，但无法对元素的位置进行精确的控制。在CSS中，通过position属性可以实现对页面元素的精确定位。基本格式如下:
iposition:static lrelative labsolute lfixed-默认值，该元素按照标准流进行布局;其中，static-
一相对定位，相对于它在原文档流的位置进行定位，它后面的盒子仍以标准流
relative-方式对待它;
absolute--绝对定位，相对于其上一个已经定位的父元素进行定位，绝对定位的盒子从标准流中脱离，它对其后的兄弟盒子的定位没有影响;
--固定定位，相对于浏览器窗口进行定位。fixed-对 box1、box2、box3 进行元素静态定位.

示例代码如下：

<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box1</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box2</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box3</view>
运行结果

对box1、box2、box3进行元素相对定位：

<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box1</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;position:relative;left: 30px;top: 30px;">box2</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box3</view>
运行结果：

对box1、box2、box3进行元素绝对定位:

<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box1</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;position:absolute;left: 30px;top: 30px;">box2</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box3</view>
运行结果：

对box1、box2、box3进行元素固定定位:

<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box1</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;position:fixed;left: 30px;top: 30px;">box2</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box3</view>
运行结果：

通过案例可以发现绝对定位和相对定位效果相同。这是因为他们的父类是page，没有定位。

如果将box1、box2、box3的父类元素采用相对定位，将box2采用绝对定位:

<view style="position: relative;top: 50px;left: 50px;border: 1px solid #00f;">
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box1</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px; position: absolute;left: 30px;top: 3opx;">box2</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box3</view>
</view>
运行结果：

box1、box2、box3的父类元素采用相对定位，将box2采用固定定位：

<view style="position: relative;top: 50px;left: 50px;border: 1px solid #f00;"></view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box1</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px; position: fixed;left: 30px;top: 3opx;">box2</view>
<view style="border: 1px solid #0f0;width: 100px;height: 100px;">box3</view>-->
运行结果：

3.4 flex布局
flex是 flexible box的缩写，意为弹性盒子模型,可以简便、完整、响应式地实现各种页面布局。

项目默认沿主轴排列。单个项目占据的主轴空间叫做main size，占据的交叉轴空间叫做cross size。flex布局模型如图所示。
设置 display属性可以将一个元素指定为ex布局，设置flex-direction 属性可以指定主轴方向。主轴既可以是水平方向，也可以是垂直方向

3.4.1容器属性
flex容器支持的属性有7种：

示例代码：

<view class="cont1">
<view class="item">1</view>
<view class="item">2</view>
<view class="item">3</view>
<view class="item">4</view>
</view>

//wxss
.box{
widows: 70px;
padding: 5px;
margin: 10px;
}
.cont1{
display: flex;
flex-direction: row;
align-items: baseline;
}
.item{
background-color: #ccc;
border: 1px solid #f00;
height: 100px;
width: 50px;
margin: 2px;
}
.item2{
height: 80px;
}
.item3{
display: flex;
height: 50px;
align-items: flex-end;
}
.item4{
height: 120px;
}

运行结果：

3.4.2：项目属性
容器内的支持项目6个属性

示例代码：

运行结果：

本章小结
本章首先介绍了页面布局中最基本的盒子模型，接下来介绍了浮动和定位，最后重点讲解了 fex 布局的基本原理、容器和项目的相关属性。大家学好这些内容，可为小程序项目的布局打下良好的基础

第四章总结

４.１组件的定义及属性
•组件是页面视图层(ＷＸＭＬ) 的基本组成单元, 组件组合可以构建功能强大的页面结构。小程序框架为开发者提供了容器视图、基础内容、表单、导航、多媒体、地图、画布、开放能力等８类(３０多个) 基础组件。
•每一个组件都由一对标签组成, 有开始标签和结束标签, 内容放置在开始标签和结束标签之间, 内容也可以是组件。组件的语法格式如下:
•< 标签名　属性名＝ ”属性值” > 内容􀆺< /标签名>
•组件通过属性来进一步细化

4.2容器视图组件
容器视图组件是能容纳其他组件的组件, 是构建小程序页面布局的基础组件, 主要包括view、scroll － view 和swiper组件。

4.2.1 view
ｖｉｅｗ组件是块级组件, 没有特殊功能, 主要用于布局展示, 相当于ＨＴＭＬ中的ｄｉｖ, 是布局中最基本的用户界面(ＵｓｅｒＩｎｔｅｒｆａｃｅ, ＵＩ) 组件, 通过设置ｖｉｅｗ的ＣＳＳ属性可以实现各种复杂的布局

<view style="display: flex;">
<View style="border: 1px solid #f00;flex-grow: 1;">1</View>
<View style="border: 1px solid #f00;flex-grow: 1;">2</View>
<View style="border: 1px solid #f00;flex-grow: 1;">3</View>
</view>
<view style="text-align: center;">上下混合布局</view>
<view style="display: flex; flex-direction: column;">
<view style="border: 1px solid #f00;">1</view>
<view style="display: flex;">
<view style="border: 1px solid #f00;flex-grow: 1;"></view>
<view style="border: 1px solid #f00;flex-grow: 2;"></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: 1px solid #f00;flex-grow: 1;">2</view>
<view style="border: 1px solid #f00;flex-grow: 2;">3</view>
</view>
</view>

运行结果：

4.2.2 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>-->

.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;
}

page {
height: 100vh;
display: flex;
flex-direction: column;
}
.scrollarea {
flex: 1;
overflow-y: hidden;
}

.userinfo {
display: flex;
flex-direction: column;
align-items: center;
color: #aaa;
width: 80%;
}

.userinfo-avatar {
overflow: hidden;
width: 128rpx;
height: 128rpx;
margin: 20rpx;
border-radius: 50%;
}

.usermotto {
margin-top: 200px;
}

.avatar-wrapper {
padding: 0;
width: 56px !important;
border-radius: 8px;
margin-top: 40px;
margin-bottom: 40px;
}

.avatar {
display: block;
width: 56px;
height: 56px;
}

.nickname-wrapper {
display: flex;
width: 100%;
padding: 16px;
box-sizing: border-box;
border-top: .5px solid rgba(0, 0, 0, 0.1);
border-bottom: .5px solid rgba(0, 0, 0, 0.1);
color: black;
}

.nickname-label {
width: 105px;
}

.nickname-input {
flex: 1;
}

4.2.3 swiper
ｓｗｉｐｅｒ组件可以实现轮播图、图片预览、滑动页面等效果。一个完整的ｓｗｉｐｅｒ组件由< ｓｗｉｐｅｒ/ > 和< ｓｗｉｐｅｒ－ｉｔｅｍ/ > 两个标签组成, 它们不能单独使用。 < ｓｗｉｐｅｒ/ > 中只能放置一个或多个< ｓｗｉｐｅｒ－ｉｔｅｍ/ > , 若放置其他组件则会被删除; < ｓｗｉｐｅｒ－ｉｔｅｍ/ > 内部可以放置任何组件, 默认宽高自动设置为１００％。

示例代码：

<swiper indicator-dots="true" autoplay="true" interval="5000" duration="1000">
<swiper-item>
<image src="/pages/index/image/ahh.jpg" style="width: 100%"></image>
</swiper-item>
<swiper-item>
<image src="/pages/index/image/cat.jpg" style="width: 100%"></image>
</swiper-item>
<swiper-item>
<image src="/pages/index/image/dog.jpg" style="width: 100%"></image>
</swiper-item>
</swiper>
运行结果

4.3基础内容组件
4.3.1 icon
ｉｃｏｎ组件即图标组件, 通常用于表示一种状态, 如ｓｕｃｃｅｓｓ、ｉｎｆｏ、ｗａｒｎ、ｗａｉｔｉｎｇ、ｃａｎｃｅｌ等。

示例代码：

<view>icon 类型:
<block wx:for="{{iconType}}">
<icon type="{{item}}"/>{{item}}
</block>
</view>
<view>icon 大小：
<block wx:for="{{iconSize}}">
<icon type="success" size="{{type}}"/>{{item}}
</block>
</view>
<view>icon 大小：
<block wx:for="{{iconColor}}">
<icon type="success" size="30" color="{{item}}"/>{{item}}
</block>
</view>
Page({
data: {
iconType: ["success", "success_no_circle", "info", "warn", "warn", "cancel", "download", "search", "clear"],
iconSize: [10, 20, 30, 40],
iconColor: ['#f00', '#0f0', '#00f']
}
})

4.3.2 text
ｔｅｘｔ组件用于展示内容, 类似ＨＴＭＬ中的< ｓｐａｎ > , ｔｅｘｔ组件中的内容支持长按选中, 支持转义字符“ ＼”, 属于行内元素。

示例代码：

Page({
data:{
x:[1,2,3,4,5],
y:[1,2,3,4,5,6,7,8,9]
}})
运行结果：

4.3.3 progress
ｐｒｏｇｒｅｓｓ组件用于显示进度状态, 如资源加载、用户资料完成度、媒体资源播放进度等。ｐｒｏｇｒｅｓｓ组件属于块级元素。

<view>显示百分比</view>
<progress percent="80" show-info="80"></progress>
<view>改变宽度</view>
<progress percent="50" stroke-width="2"></progress>
<view>自动显示进度条</view>
<progress percent="80" active=""></progress>

4.4 表单组件
•表单组件的主要功能是收集用户信息, 并将这些信息传递给后台服务器, 实现小程序与用户之间的沟通。表单组件不仅可以放置在< ｆｏｒｍ/ > 标签中使用, 还可以作为单独组件和其他组件混合使用。

4.4.1 button
•ｂｕｔｔｏｎ组件用来实现用户和应用之间的交互, 同时按钮的颜色起引导作用。一般来说,在一个程序中一个按钮至少有３种状态: 默认点击(ｄｅｆａｕｌｔ)、建议点击(ｐｒｉｍａｒｙ)、谨慎点击(ｗａｒｎ)。

<button type="default">type:default</button>
<button type="primary">type:primary</button>
<button type="warn">type:warn</button>
<button type="default" bindtap="buttonSize" size="{{size}}">改变size</button>
<button type="default" bindtap="buttonPlain" plain="{{plain}}">改变plain</button>
<button type="default" bindtap="buttonLoading" loading="{{loading}}">改变loading显示</button>

4.4.2 radio
单选框用来从一组选项中选取一个选项。在小程序中, 单选框由< ｒａｄｉｏ－ｇｒｏｕｐ/ > (单项选择器) 和< ｒａｄｉｏ/ > ( 单选项目) 两个组件组合而成, 一个包含多个< ｒａｄｉｏ/ > 的< ｒａｄｉｏ－ｇｒｏｕｐ/ > 表示一组单选项, 在同一组单选项中< ｒａｄｉｏ/ > 是互斥的, 当一个按钮被选中后, 之前选中的按钮就变为非选。

<view>选择您喜爱的城市</view>
<radio-group bindchange="citychange">
<radio value="西安">西安</radio>
<radio value="北京">北京</radio>
<radio value="上海">上海</radio>
<radio value="广州">广州</radio>
<radio value="深圳">’深圳</radio>
</radio-group>
<view>你的选择:{{city}}</view>

<view>选择你喜爱的计算机语言:</view>
<radio-group class="radio-group" bindchange="radiochange">
<label class="radio" wx:for="{{radios}}">
<radio value="{{item.value}}" checked="{{item.checked}}"/>
{{item.name}}
</label >
</radio-group>
<view>你的选择：{{lang}}</view>

Page({
data:{
radios:[
{name:'java',value:'JAVA'},
{name:'python',value:'Python',checked:'ture'},
{name:'php',value:'PHP'},
{name:'swif',value:'Swif'},
],
city:"",
lang:""
},
citychange:function(e){
this.setData({city:e.detail.value});
},
radiochange:function(event){
this.setData({lang:event.detail.value});
console.log(event.detail.value)
}
})

4.4.3 checkbox
复选框用于从一组选项中选取多个选项, 小程序中复选框由< ｃｈｅｃｋｂｏｘ－ｇｒｏｕｐ/ > (多项选择器) 和< ｃｈｅｃｋｂｏｘ/ > (多选项目) 两个组件组合而成。一个< ｃｈｅｃｋｂｏｘ－ｇｒｏｕｐ/ > 表示一组选项, 可以在一组选项中选中多个选项。

<view>选择您想去的城市:</view>
<checkbox-group bindchange="cityChange">
<label wx:for="{{citys}}">
<checkbox value="{{item.value}}" checked="{{item.checked}}">
{{item.value}}
</checkbox>
</label>
</checkbox-group>
<view>您的选择是:{{city}}</view>
Page({
city:"",
data:{
citys:[
{name:'km',value:'昆明'},
{name:'sy',value:'三亚'},
{name:'zh',value:'珠海',checked:'ture'},
{name:'dl',value:'大连'}]
},
cityChange:function(e){
console.log(e.detail.value);
var city=e.detail.value;
this,this.setData({city:city})
}
})

4.4.4 switch
switch 组件的作用类似开关选择器，其属性如表所示:

示例代码如下：

<view>
<switch bindchange="sw1">{{var1}}</switch>
</view>
<view>
<switch checked bindchange="sw2">{{var2}}</switch>
</view>
<view>
<switch type="checkbox" bindchange="sw3">{{var3}}</switch>
</view>
Page({
data:{
var1:'关',
var2:'开',
var3:'未选'
},
sw1:function(e){
this.setData({var1:e.detail.value?'开':'关'})
},
sw2:function(e){
this.setData({var3:e.detail.value?'开':'关'})
},
sw3:function(e){
this.setData({var3:e.detail.value?'已选':'未选'})
},
})

4.4.5 slider
ｓｌｉｄｅｒ组件为滑动选择器, 可以通过滑动来设置相应的值, 其属性如图所示：

示例代码：

<view>默认min=0 max=100 step=1</view>
<slider></slider>
<view>显示当前值</view>
<slider show-value></slider>
<view>设置min=20max=200 step=10</view>
<slider min='0'max='200' step='10' show-value></slider>

<view>背景色红色，已选定颜色绿色</view>
<slider color="#f00" selected-color='#0f0'></slider>

<view>滑动改变icon的大小</view>
<slider show-value bindchange='sliderchange'></slider>
<icon type="success" size='{{size}}'></icon>
Page({
data:{
size:'20'
},
sliderchange:function(e){
this.setData({size:e.detail.value})
}
})

4.4.6 picker
•ｐｉｃｋｅｒ组件为滚动选择器, 当用户点击ｐｉｃｋｅｒ组件时, 系统从底部弹出选择器供用户选择。ｐｉｃｋｅｒ组件目前支持５种选择器, 分别是: ｓｅｌｅｃｔｏｒ (普通选择器)、ｍｕｌｔｉＳｅｌｅｃｔｏｒ (多列选择器)、ｔｉｍｅ (时间选择器)、ｄａｔｅ (日期选择器)、ｒｅｇｉｏｎ (省市选择器)。

1. 普通选择器
普通选择器(modelector)的属性如图所示：

<view>--range为数组---</view>
<picker range="{{array}}" value="{{index1}}" bindchange="arrayChange">
当前选择:{{array[index1]}}
</picker>

<view>---range为数组对象---</view>
<picker bindchange="objArrayChange" value="{{index2}}" range-key="name"range="{{objArray}}">
当前选择:{{objArray[index2].name}}
</picker>
Page({
data:{
array:['Java','Python','C','C#'],
objArray:[
{id:0,name:'Java'},
{id:1,name:'Python'},
{id:2,name:'C'},
{id:3,name:'C#'}
],
index1:0,
index2:0
},
arrayChange:function(e){
console.log('picker值变为',e.detail.value)
var index=0;
this.setData({
index1:e.detail.value
})
},
objArrayChange:function(e){
console.log('picker值变为',e.detail.value)
this.setData({
index2:e.detail.value
})
}
})

2.多列选择器
多列选择器(ｍｏｄｅ＝ｍｕｌｔｉＳｅｌｅｃｔｏｒ) 允许用户从不同列中选择不同的选择项, 其选项是二维数组或数组对象。多列选择器的属性如图所示：

示例代码：

<view>多列选择器</view>
<picker
rmode="multiSelector"
bindchange="bindMultipickerChange"
bindcolumnchange="bindMultipickerColumnChange"
value="{{multiIndex}}"
range="{{multiArray}}">
<view>
当前选择：{{multiArray[0][multiIndex[0]]}},
{{multiArray[1][multiIndex[1]]}},
{{multiArray[2][multiIndex[2]]}}
</view>
</picker>
Page({
data: {
multiArray: [['陕西省', '广东省'], ['西安市', '汉中市', '延安市'], ['雁塔市', '长安市']],
multiIndex: [0, 0, 0]
//绑定Multipicker
},
bindMultipickerChange: function (e) {
console.log('picker 发送选择改变,携带值为', e.detail.value);
this.setData({
multiIndex: e.detail.value
});
},
//绑定MultipickerColumn
bindMultipickerChange: function (e) {
console.log = ('修改的列为', e.detail.console, '值', e.detail.value);
var data = {
multiArray: this.data.multiArray,
multiArray: this.data.multiIndex
};
data.multiIndex[e.detail.column] = e.detail.value;
switch (e.detail.column) {
case 0:
switch (data.multiIndex[0]) {
case 0:
data.multiIndex[1] = ['西安市', '汉中市', '延安市'];
data.multiIndex[2] = ['雁塔市', '长安市'];
break;
case 1:
data.multiIndex[1] = ['深圳市', '珠海市'];
data.multiIndex[2] = ['南山市', '罗湖区'];
break;
}
data.multiIndex[1] = 0;
data.multiIndex[2] = 0;
break;
}
}
})

3.时间选择器，日期选择器
时间选择器(mode=time)可以用于从提供的时间选项中选择相应的时间,其属性如表所示。

日期选择器(mode=date)可以用于从提供的日期选项中选择相应的日期,其属性如表所示。

示例代码：

<view>
<picker mode="date" start="{{startdate}}" end="{{enddate}}"
value="{{date}}" bindchange="changedate">
选择的日期:{{date}}
</picker>
</view>
<view>
<picker mode="time" start="{{starttime}}" end="{{endtime}}"
bindchange="changetime">
选择的时间:{{time}}
</picker>
</view>
Page({
data:{
startdata:2000,
enddate:2050,
date:'2018',
starttime:'12:59',
time:'8:00'
},
changedate:function(e){
this.setData({date:e.detail.value});
console.log(e.detail.value)
},
changedate:function(e){
this.setData({date:e.detail.value})
console.log(e.detail.value)
}
})

4.省级选择器
省级选择器（mode=region）是小程序的新版本提供的快速地区组件，其属性如图所示

示例代码：

page({
data:{
region:['陕西省','西安市','长安区'],
customitem:'全部'
},
changeregion:function(e){
console.log(e.detail.value)
this.setData({
region:e.detail.value
})
}
})

<picker mode="region" value="{{region}}" custom-item="{{cust-omitem}}"bindchange="changeregion">
选择省市区：{{region[0]}},{{region[1]}},{{region[1]}}
</picker>

4.4.7 picker-view
ｐｉｃｋｅｒ－ｖｉｅｗ组件为嵌入页面的滚动选择器。相对于ｐｉｃｋｅｒ组件, ｐｉｃｋｅｒ－ｖｉｅｗ组件的列的个数和列的内容由用户通过< ｐｉｃｋｅｒ－ｖｉｅｗ－ｃｏｌｕｍｎ/ > 自定义设置。

示例代码：

<view>当前日期:{{year}}年{{month}}月{{day}}日</view >
<picker-view indicator-style="height:50px;" style ="width:100%; height:300px;"
value ="{{value}}" bindchange ="bindchange">
<picker-view-column>
<view wx:for="{{years}}"style="line-height:50px">{{item}}年</view>
</picker-view-column>
<picker-view-column>
<view wx:for="{{months}}" style ="line-height:50px">{{item}}月</view>
</picker-view-column>
<picker-view-column>
<view wx:for="{{days}}" style="line-height:50px">{{item}}日</view>
</picker-view-column>
</picker-view>
const date =new Date()
const years=[]
const months=[]
const days=[]
//定义年份
for(let i=1900;i<=2050;i++){
years.push(i)
}
//定义月份
for(let i=1;i<=12;i++){
months.push(i)
}
//定义日期
for(let i=1;i<=31;i++){
days.push(i)
}
Page({
data:{
years:years,
months:months,
days:days,
year:date.getFullYear(),
month:date.getMonth()+1,day:date.getDate(),value:[118,0,0],
},
//定位到2018年1月1日
bindChange:function(e){
const val =e.detail.value
console.log(val);
this.setData({
year:this.data.years[val[0]],
month:this.data.months[val[1]],
day:this.data.days[val[2]]
})
}
})

4.4.8 input
input为组件输入框，用户可以输入相应的信息，其属性如下：

示例代码：

<input placeholder="这是一个可以自动聚焦的 input" auto-focus/>
<input placeholder="这个只有在按钮点击的时候才聚焦" focus ="{{focus}}"/>
<button bindtap="bindButtonTap">使得输入框获取焦点</button>
<input maxlength="10" placeholder="最大输入长度为10"/>
<view class="section_title">你输入的是:{{inputValue}}</view>
<input bindinput="bindKeyInput" placeholder="输入同步到view中"/>
<input bindinput="bindReplaceInput" placeholder="连续的两个1会变成2"/>
<input password type="number"/>
<input password type="text"/>
<input type="digit" placeholder="带小数点的数字键盘"/>
<input type="idcard" placeholder="身份证输入键盘"/>
<input placeholder-style="color:red" placeholder="占位符字体是红色的"/>
Page({
data:{
focus:false,
inputValue:""
},
bindButtonTap:function(){
this.setData({
focus:true
})
},
bindKeyInput:function(e){
this.setData({
inputValue:e.detail.value
})
},
bindReplaceInput:function(e){
var value =e.detail.value
var pos =e.detail.cursor
if(pos!=-1){
//光标在中间
var left =e.detail.value.slice(0,pos)
//计算光标的位置
pos =left.replace(/11/g,'2').length
}
//直接返回对象,可以对输入进行过滤处理,同时可以控制光标的位置
return{
value:value.replace(/11/g,'2'),
Cursor:pos
}
//或者直接返回字符串,光标在最后边
//return value.replace( /11 /g,'2'),
}
})

4.4.9 textarea
textarea组件为多行输入框组件，可以实现多行内容的输入，属性如图所示：

示例代码：

<textarea bindblur="bindTextAreaBlur"auto-height placeholder="自动变高"></textarea>
<textarea placeholder="placeholder 颜色是红色的" placeholder-style="color:red;"></textarea>
<input placeholder="这是一个可以自动聚焦的 input" auto-focus/>
<input placeholder="这个只有在按钮点击的时候才聚焦" focus ="{{focus}}"/>
<button bindtap="bindButtonTap">使得输入框获取焦点</button>
<input maxlength="10" placeholder="最大输入长度为10"/>
<view class="section_title">你输入的是:{{inputValue}}</view>
<input bindinput="bindKeyInput" placeholder="输入同步到view中"/>
<input bindinput="bindReplaceInput" placeholder="连续的两个1会变成2"/>
<input password type="number"/>
<input password type="text"/>
<input type="digit" placeholder="带小数点的数字键盘"/>
<input type="idcard" placeholder="身份证输入键盘"/>
<input placeholder-style="color:red" placeholder="占位符字体是红色的"/>
Page({
data:{
height:10,
focus:false
},
bindButtonTap:function(){
this.setData({
focus:true
})
},
bindTextAreaBlur:function(e){
console.log(e.detail.value)
},
bindFormSubmit:function(e){
console.log(e.detail.value.textarea)
}
})

4.4.10 label
label组件为标签组件，用于提升表单组件的可用性。label组件支持使用for属性找到对应的id,或者将控件放在该标签下，当点击label组件时，就会触发对应的控件。for属性的优先级高于内部控件，内部有多个控件的时候默认触发第一个控件。
目前，label组件可以绑定的控件有<button/ >、<checkbox/ >、<radio/>、<switch/ >。

示例代码

<view><checkbox></checkbox>中国</view>

<view><label><checkbox> </checkbox >中国</label></view>

<checkbox-group bindchange="cityChange">
<label wx:for="{{citys}}">
<checkbox value ="{{item.value}}" checked = '{{item.checked}}'>
{{item.value}}</checkbox>
</label>
</checkbox-group>
<view>您的选择是:{{city}}</view>
Page({
city:"",
data:{
citys:[
{name:'km',value:'昆明'},
{name:'sy',value:'三亚'},
{name:'zh',value:'珠海',checked:'true'},
{name:'dl',value:'大连'}]
},
cityChange:function(e){
console.log(e.detail.value);
var city =e.detail.value;
this.setData({city: city})
}
})

4.4.11 from
ｆｏｒｍ组件为表单组件, 用来实现将组件内的用户输入信息进行提交。当< ｆｏｒｍ/ > 表单中ｆｏｒｍＴｙｐｅ为ｓｕｂｍｉｔ的< ｂｕｔｔｏｎ/ > 组件时, 会将表单组件中的ｖａｌｕｅ值进行提交。

示例代码：

<form bindsubmit ="formSubmit " bindreset ="formReset ">
<view>姓名:
<input type="text"name="xm"/>
</view>
<view>性别:
<radio-group name="xb">
<label><radio value="男" checked/>男</label>
<label><radio value="女"/>女</label>
</radio-group>
</view>
<view>爱好:
<checkbox-group name="hobby">
<label wx:for="{{hobbies}}">
<checkbox value="{{item.value}}" checked='{{item.checked}}'>{{item.value}}</checkbox>
</label>
</checkbox-group>
</view>
<button formType='submit'>提交</button>
<button formrype='reset'>重置</button>
</form>

Page({
hobby :"",
data:{
hobbies :[
{name:'jsj',value:'计算机',checked:'true'},
{name:'music',value:'听音乐'},
{name:'game',value:'玩电竟'},
{name:'swim',value:'游泳',checked:'true'}]
},
formSubmit:function(e){
console.log('form发生了submit事件，携带数据为:'.e.detail.value)
},
formReset:function(){
console.log('form发生了reset事件')
}
})

4.5 多媒体组件
多媒体组件包括ｉｍａｇｅ (图像)、ａｕｄｉｏ (音频)、ｖｉｄｅｏ (视频)、ｃａｍｅｒａ (相机) 组件,使用这些组件, 可以让页面更具有吸引力。

4.5.1 image
ｉｍａｇｅ组件为图像组件, 与ＨＴＭＬ中的< ｉｍｇ/ > 类似, 系统默认ｉｍａｇｅ组件的宽度为３００ｐｘ、高度为２２５０ｐｘ, ｉｍａｇｅ组件的属性如表所示。

ｉｍａｇｅ组件中的ｍｏｄｅ属性有１３种模式, 其中缩放模式有４种, 裁剪模式有９种。

1.缩放模式
ｓｃａｌｅＴｏＦｉｌｌ不保持纵横比缩放图片, 使图片的宽高完全拉伸至填满ｉｍａｇｅ元素。

ａｓｐｅｃｔＦｉｔ保持纵横比缩放图片, 使图片的长边能完全显示出来。也就是说, 可以将图片完整地显示出来。

ａｓｐｅｃｔＦｉｌｌ保持纵横比缩放图片, 只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的, 在另一个方向将会发生截取。

ｗｉｄｔｈＦｉｘ宽度不变, 高度自动变化, 保持原图宽高比不不变

示例代码：

<block wx:for ="{{modes}}">
<view>当前图片的模式是:{{item}}</view>
<image mode ="{{item}}" src ="/pages/index/image/ahh.jpg" style ="width:100%,height:100%"/>
</block>
Page({
data:{
modes:['scaleToFill','aspectFit','aspectFill','widthFrix']
}
})

2.裁剪模式
ｔｏｐ不缩放图片, 只显示图片的顶部区域。

ｂｏｔｔｏｍ不缩放图片, 只显示图片的底部区域。

ｃｅｎｔｅｒ不缩放图片, 只显示图片的中间区域。

ｌｅｆｔ不缩放图片, 只显示图片的左边区域。

ｒｉｇｈｔ不缩放图片, 只显示图片的右边区域。

ｔｏｐ＿ｌｅｆｔ不缩放图片, 只显示图片的左上边区域。

ｔｏｐ＿ｒｉｇｈｔ不缩放图片, 只显示图片的右上边区域。

ｂｏｔｔｏｍ＿ｌｅｆｔ不缩放图片, 只显示图片的左下边区域。

示例代码：

Page({
data:{
modes:['top','center','left','right','top_left','top_right','bottom_left','bottom_right']
}
})
Page({
data:{
modes:['top','center','left','right','top_left','top_right','bottom_left','bottom_right']
}
})

4.5.2 audio
audio 组件用来实现音乐播放，暂停等，其属性如下：

示例代码：

<audio src ="{{src}}" action="{{action}}" poster = "{{poster}}" name = "{{name}}" author ="{{author}} " loop controls></audio >
<button type="primary" bindtap='play'>播放</button >
<button type="primary" bindtap="pause">暂停</button >
<button type ="primary" bindtap="playRate">设置速率</button>
<button type="primary" bindtap="currentTime">设置当前时间(秒)
</button>
Page( {
data:{
poster:'http://.gtimg.cn/usic/hoto new/002R300x300M000003rsKF44Gyask.jpg?max age=2592000',
name:'此时此刻',
author:'许巍',
src:'http://ws.stream.qqmusic.gg.comM500001VfvsJ21xFab.mp3? guidffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E06DCBDC9AB7C49FD713D632D313AC4858BACB8DDD29067D3C601481D36E62053BF8DFEAF74C0A5CCFADD6471160CAF3E6A&fromtag=46',
},
play:function(){
this.setData({
action:{
method: 'play'
}
})
},
pause:function(){
this.setData({
action:{
method: 'pause'
}
})
},
playRate:function(){
this.setData({
action:{
method:'setPlaybackRate',
data:10 //速率
}
})
console.log('当前速率:'+this.data.action.data)
},
currentTime:function(e){
this.setData({
action:{
method:'setCurrentTime',
data:120
}
})
}
})

4.5.3 video
用于实现视频的播放与暂停等，视频默认宽度为300px，高为225px。属性如下：

示例代码如下：

Page({
data:{
srC:"",
},
bindButtonTap:function(){
var that =this
wx.chooseVideo()({
sourceType: [ 'album' ,'camera'],
maxDuration:60,
camera:['front','back'],
success:function(res){
that.setData({
src:res.tempFilePath
})
}
})
}
})

4.5.4 camera
ｃａｍｅｒａ组件为系统相机组件, 可以实现拍照或录像功能。在一个页面中, 只能有一个ｃａｍｅｒａ组件。在开发工具中运行时, 使用电脑摄像头实现拍照或录像; 在手机中运行时, 使用手机前后摄像头实现拍照或录像。

<camera device-position ="back" flash ="off" binderror ="error"
style="width:100%;height:350px;"></camera>
<button type ="primary" bindtap ="takePhoto" >拍照</button ><view>预览</view >
<image mode ="widthFix" src ="{{src}}"></image>
Page({
takePhoto(){
const ctx=wx.createCameraContext()//创建并返回 camera上下文对象/拍照,成功则返回图片
ctx.takePhoto({
quality:' high',
success:(res)=>{
this.setData({
src:res.tempImagePath
})
}
})
},
error(e){
console.log(e.detail)
}
})

4.6 其他组件
在小程序中，除了前面介绍的组件以外，map组件和canvas组件1比较常用。

4.6.1 map
map组件用于在页面中显示地图或路径，常用于LBS(基于位置服务)或路径指引,功能相对百度地图、高德地图较简单，目前具备绘制图标、路线、半径等能力，不能在croll-view、swiper、picker-view、movable -view组件中使用。map组件的属性如表所示:

map组件的markers属性用于在地图上显示标记的位置，属性如下：

map组件的palyhine 属性用来指定一系列坐标点，从数组第杉成条路线，可以指定线的颜色、宽度、线型以及是否带箭头等，其关属性如表所示：

<map id="map"
longitude ="108.9200"
latitude="34.1550"
scale ="14"
controls="{{controls}}"
bindcontroltap="contro1tap"
markers="{{markers}}"
bindmarkertap="markertap"
polyline="{{polyline}}"
bindregiοnchange="regionchange"
show-location
style="width:100%;height:300;">
</map>
Page({
data:{
markers:[{
iconPath:"/pages/news/3.gif",
id:0,
longitude:"108.9290",
latitude:"34.1480",
width:50,
height:50
}],
polyline:[{
points:[
{
longitude:"108.9200",
latitude:"34.1400",
},
{
longitude:"108.9200",
latitude:"34.1500",
},
{
longitude:"108.9200",
latitude:"34.1700",
}
],
color:"#00ff00",
width:2,
dottedLine:true
}],
controls:[{
id:1,
iconPath:'/pages/news/3.gif',
position: {
left:0,
top:300,
width:30,
height:30,
},
clickable:true
}]
},
regionchange(e){
console.log(e.type)
},
markertap(e) {
console.log(e.markerId)
},
controltap(e){
console.log(e.controlId)
}
})

4.6.2 canvas
canvas组件用来绘制图形，相当于一块无色透明的普通图布。canvas组件本身并没有绘图能力、仅仅是图形容器，通过绘图AP1实现绘图功能。在默认情况下，canvas组件的默认宽度为300px，高度为225px，同一页面中的canvas-id不能重复，否则会出错。

实现绘图需要三步：

1.创建一个canvas绘图上下文

var context=wx.createCanvasContext('myCanvas')
2.使用canvas绘图上下文进行描述

context.setFillStyle('green')//设置绘图上下文的填充色为绿色
context.fillRect(10,10,200,100)//方法画一个矩形，填充色为设置的绿色
3.画图

context.draw()
示例代码：

<canvas canvas-id="maCanvas" style="border: 1px solid red;"></canvas>
Page({
onLoad:function(options){
var ctx =wx.createCanvasContext('myCanvas')
ctx.setFillStyle('green')
ctx.fillRect(10,10,200,100)
ctx.draw()
}
})

4.7本章小结
本章介绍了小程序中的常用组件，包括容器组件(view、seroll-view、swiper)、基础内容组件(icon、text、progress、rich-text)、表单组件(form、input、button、radio、check-box、label、picker、picker-view、slider、swich、textarea)、多媒体组件( audio、image、video、camera)、其他组件(map、canvas等)。熟练掌握这些组件的属性和方法是开发小程序的必备技能。

第五章总结

1.即速应用的优势
即速应用是深圳市咫尺网络科技开发有限公司开发的一款同时兼具微信小程序和支付宝小程序快速开发能力的工具, 用户只需简单拖拽可视化组件, 就可以实现在线小程序开发。

即速应用的功能特点主要体现在以下几个方面:

１.开发流程简单
,零门槛制作使用即速应用来开发微信小程序的过程非常简单, 无须储备相关代码知识, 没有开发经验的人也可以轻松上手。

(１) 登录即速应用的官方网站(ｗｗｗ.ｊｉｓｕａｐｐ.ｃｎ), 进入制作界面, 从众多行业模板中选择一个合适的模板。

(２) 在模板的基础上进行简单编辑和个性化制作。

(３) 制作完成后, 将代码一键打包并下载。

(４) 将代码上传至微信开发者工具。

(５) 上传成功后, 等待审核通过即可。

２.行业模板多样
种类齐全即速应用为广大开发者提供了非常齐全的行业解决方案。目前, 即速应用已经上线６０多个小程序行业模板, 涉及餐饮(单店版、多店版)、婚庆、旅游、运动、美容、房地产、家居、医药、母婴、摄影、社区、酒店、ＫＴＶ、汽车、资讯等多个行业。这些小程序行业模板可以有效地帮助企业拓宽资源整合渠道, 降低运营成本, 提高管理效率。

３.丰富的功能组件和强大的管理后台
即速应用的功能组件和管理后台非常实用, 可以根据实际情况解决商家的不同需求。

3.即速应用界面介绍
登录即速应用官网, 单击“注册” 按钮, 在如图所示的页面填写相应信息, 即可完成注册。完成注册后, 即可登录账号, 使用即速应用。

即速应用的主界面主要分为４个区域, 分别为菜单栏、工具栏、编辑区和属性面板。

1.菜单栏中的“风格” 选项用于设置小程序页面的风格颜色, “管理” 选项用于进入后台管理页面, “帮助” 选项用于提示帮助功能, “客服” 选项用于进入客服界面, “历史”选项用来恢复前项操作, “预览” 选项用在ＰＣ端预览制作效果, “保存” 选项用于保存已制作的内容, “生成” 选项用于实现小程序打包上线设置。

２.工具栏工具栏包括“页面管理” “组件库” ２个选项卡, “页面管理” 实现添加页面和添加分组以及对某一页面进行改名。

３.编辑区编辑区是用来制作小程序页面的主要区域, 通过拖拽组件实现页面制作, 右边的“前进” “后退” 选项可以进行恢复操作, “模板” 选项可以用来选择模板, “元素” 选项可以用来显示页面中的组件及其层次关系, “数据” 选项可以用来进行页面数据管理, “模块” 选项可以用来选择模块。

４.属性面板属性面板用来设置选定组件的属性及样式, 包括“组件” 和“组件样式” 两个选项卡。“组件” 选项卡用来设置组件内容及点击事件; “组件样式” 选项卡用来设置组件的样式,不同组件有不同的样式需要设置。

即速应用提供了大量的组件供用户快速布局页面, 包括７个布局组件、９个基本组件、１８个高级组件和２个其他组件。

２. 布局组件
布局组件用于设计页面布局, 主要包括双栏、面板、自由面板、顶部导航、底部导航、分割线和动态分类,如图所示。

１.双栏组件
双栏组件用来布局整体, 它可以把一个区块分为两部分, 操作时显示一个分隔的标志, 便于操作, 预览时则不会出现。双栏组件默认设置每个栏占５０％总宽, 也可以按实际需要调整比例。双栏里面可以添加基本的组件, 从而达到整体的布局效果。双栏还可以嵌套双栏, 即可以在其中的一个栏里嵌入一个双栏, 从而将整体分成３部分(若需要将整体分成４部分, 就再嵌套一个双栏, 依次类推)。双栏组件的属性面板如图所示。

２.面板组件
面板组件相当于一个大画板, 用户可以将很多基本(甚至高级) 的组件(如文本组件、图片组件、按钮组件、标题组件、分类组件、音频组件、双栏组件、计数组件等) 放进面板组件里一起管理。面板组件的属性面板如图所示。

３.自由面板组件
自由面板组件是指放置在该面板内的组件可以自由拖动, 调节组件大小。用户既可以向自由面板内拖入部分组件(包括文本组件、图片组件和按钮组件), 也可以拖入任意相关容器组件, 用于不规则布局。自由面板组件的属性面板如图所示。

４.顶部导航组件
顶部导航组件固定于页面顶部, 用于编辑顶部的导航。常用的手机应用在顶部有一条导航, 上面写有手机应用Ａｐｐ的名称或ｌｏｇｏ, 以及返回键等。顶部导航组件的属性面板设置如图所示。

５.底部导航组件底部导航组件固定于页面底部, 用于编辑底部的导航。底部导航组件的属性面板设置如图1所示。通过底部导航组件可以添加标签、删除标签, 同时可以分别设置每个标签的名称、原始图片、点击图片及链接至某一页面; 通过组件面板可以进行组件背景色、图片及文字的设置。

６.分割线组件
分割线组件被放置于任意组件之间, 用于实现分割。

７.动态分类组件
动态分类组件仅适用于电商、到店类小程序。用户通过选择动态分类组件的样式, 可以实现顶部分类、侧边栏分类来展示应用数据、商品数据等。动态分类的二级有图模式只适用于电商类小程序。动态分类组件的属性面板如图所示。

4.基本组件
基本组件是小程序页面常用的组件, 包括文本、图片、按钮、标题、轮播、分类、图片列表、图文集和视频。

1.文本组件
文本组件用于展示文字、设置点击事件,是小程序页面中最常用的组件。文本组件的属性面板如图所示。

２.图片组件
图片组件用于在页面中展示图片, 其属性面板如图所示。

３.按钮组件
按钮组件用于在页面中设置按钮, 其属性面板如图所示。

４.标题组件
标题组件用于在页面中设置标题, 其属性面板如图所示。

５.轮播组件
轮播组件用于实现图片的轮播展示, 其属性面板。单击“添加轮播分组” 按钮进入管理后台, 然后单击“轮播管理” → “新建分组” 选项可以创建轮播分组, 如图。分别填写“分组名称” 和“分组描述”, 单击“确定” 按钮进入轮播管理界面。单击“轮播项” 按钮, 进入页面。单击“添加轮播” 按钮, 在图所示的页面进行轮播项的设置。根据需要添加相应的轮播。

单击“编辑” 按钮,所示的绑定轮播分组中选定“ｂａｎｎｅｒ” 轮播分组, 单击“预览” 按钮, 将出现预览效果。

６.分类组件
分类组件可以设置不同内容展示在不同类别中, 还可以添加、删除分类的个数及进行相应的设置。分类组件的属性面板如图所示

７.图片列表组件
图片列表组件可以将图片以列表的形式展示, 还可以设置图片的名称、标题和点击事件。图片列表组件的属性面板如图所示。

８.图文集组件
图文集组件用于展示图片、标题和简介, 其属性面板如图所示。

９.视频组件
视频组件用于展示视频, 。视频组件提供网页应用、小程序和云服务３种视频来源。网页应用使用视频通用代码来确定视频来源.

5. 高级组件
高级组件通常需要后台数据, 通过设置后台数据来实现数据后台化, 让小程序的数据随时更新, 及时修改, 如图所示。下面介绍其中的几种常用组件。

１.动态列表组件
动态列表组件是容纳基础组件来展示后台数据的容器, 通过添加基础组件来展示对应的后台数据, 其属性面板如图所示。

２.个人中心组件
个人中心组件显示个人相关信息的组件, 包括图像、昵称、我的订单、收货地址、购物车等, 如图所示。个人中心组件的属性面板如图2所示。

３.动态表单组件
动态表单组件相当于ＨＴＭＬ中的< ｆｏｒｍ > 标签, 是一个容器组件, 可以添加子表单组件和基本组件, 用来收集用户提交的相关信息给后台数据对象。动态表单组件的属性面板如图所示。

４.评论组件
评论组件提供信息发布或回复信息的组件, 评论组件的属性面板如图所示。

５.计数组件
计数组件可以用于点赞、统计浏览量等类似的计数功能。计数组件的属性面板如图所示。

６.地图组件
地图组件用于显示指定地址的地图, 常用于实现定位及导航功能。

７.城市定位组件
城市定位组件通常与列表类组件搭配使用, 常见搭配有动态列表和商品列表。例如, 城市定位组件与商品列表搭配, 可以实现通过城市定位来搜索出某具体位置信息下的商品列表。

８.悬浮窗组件
悬浮窗组件的固定搭配有: 客服、我的订单、购物车、回到顶部。悬浮窗组件通常出现在个人中心或商品列表页面

5.其他组件
其他组件包括音频组件和动态容器组件。

１.音频组件
传播数据主要是用于提供新老访客的比例, 以及访客使用哪些主要平台打开应用的次数及占比。

２.分享设置
分享设置主要提供可以分享应用的方式, 如图所示。

３.用户管理
用户管理主要用于实现对用户进行添加、分组、群发消息、储值金充值、赠送会员卡等功能, 如图５－６所示。

４.应用数据
应用数据是后台管理的主要内容, 前端组件(动态列表、动态表单) 的数据都是通过在应用数据中的数据对象来管理的, 类似通过数据库存放和管理数据。

５. 轮播管理
轮播管理是前端软播组件的后台数据管理器, 通过软播管理来设置前端软播组件展示的图片内容。

６. 分类管理
分类管理适用于电商、到店、应用数据。分类管理可以通过选择动态分类组件样式来实现在顶部分类或侧边栏分类以展示应用数据、商品数据等效果。动态分类的二级有图模式只适用于电商。

７. 商品管理
商品管理是后台管理的主要内容, 前端商品列表组件的数据来源于后台商品管理。商品管理可以管理商品列表、积分商品、位置管理、支付方式、订单管理、拼团订单管理、订单统计、账单明细、运费管理和评价管理功能。

８.经营管理
经营管理主要包括子账号管理、手机端客户关系管理和短信接收管理, 便于管理者管理小程序的运营。

９.营销工具
营销工具是小程序营销推广的有力工具, 主要有会员卡、优惠券、积分、储值、推广、秒杀、集集乐、拼团活动、大转盘、砸金蛋、刮刮乐等。这些营销工具都需要事前在后台合理设置后, 才能在活动中发挥更大的作用。

１０.多商家管理
多商家管理是即速应用为有众多商家的商城(如“华东商城” “义乌商城” 等) 开设的管理功能, 方便管理者统计每家店铺的订单及进行收益分析。

6.打包上传
即速应用可以将小程序的代码打包, 该代码包可以通过微信开发者工具来对接微信小程序。

1.打包
进入即速应用后台管理, 选择左边选项“分享设置” 按钮, 单击“微信小程序” 选项, 进入如图５－６１所示的页面。选择“代码包下载” 选项, 单击“确定” 按钮, 进入如图1所示的页面。通过“微信公众平台→小程序→设置→开发设置” 获取ＡｐｐＩＤ和ＡｐｐＳｅｃｒｅｔ, 在“服务器配置” 中填写相关信息, 选择相应分类, 单击“打包” 按钮, 即可成功打包, 如图2所示。单击“下载” 按钮, 即可下载该小程序代码包。

2.上传
打开微信Ｗｅｂ开发者工具, 新建项目, 并填写相关内容。其中, 项目目录为下载包解压后的目录, 如图1 所示。单击“确定” 按钮, 打开小程序代码, 编译无误后, 填写该项目的版本号, 单击“上传” 按钮即可实现该小程序代码上传。上传成功后, 打开微信公众平台的“开发管理” 界面, 就可以看到该小程序的版本信息。待审核通过后, 即可在“微信” → “发现” → “小程序”

第六章总结

1.网络API
微信小程序处理的数据通常从后台服务器获取, 再将处理过的结果保存到后台服务器,这就要求微信小程序要有与后台进行交互的能力。微信原生ＡＰＩ接口或第三方ＡＰＩ提供了各类接口实现前后端交互。

网络ＡＰＩ可以帮助开发者实现网络ＵＲＬ访问调用、文件的上传和下载、网络套接字的使用等功能处理。微信开发团队提供了１０个网络ＡＰＩ接口。

1. wx.request（Object）接口用于发起HTTPS请求。
2.wx.uploadFile（Object）接口用于将本地资源上传到后台服务器。

3.wx.downloadFile（Object）接口用于下载文件资源到本地。
4.wx.connectSocket（Object）接口用于创建一个WebSocket连接。
5.wx.sendSocketMessage（Object）接口用于实现通过WebSocket连接发送数据。
6.wx.closeSocket（Object）接口用于关闭WebSocket连接。
7.wx.onSocketOpen（CallBack）接口用于监听WebSocket连接打开事件。
8.wx.onSocketError（CallBack）接口用于监听WebSocket错误。
9.wx.onSocketMessage（CallBack）接口用于实现监听WebSocket接收到服务器的消息事件。
10.wx.onSocketClose（CallBack）接口用于实现监听WebSocket关闭。

在本节, 我们将介绍常用的３个网络ＡＰＩ。

1.1 发起网络请求
ｗｘ.ｒｅｑｕｅｓｔ(Ｏｂｊｅｃｔ) 实现向服务器发送请求、获取数据等各种网络交互操作, 其相关参数如表所示。

例如，通过wx.request(0bject)获取百度(https://www.baidu.com)首页数据。需要在微信小程序公众平台服务器中的request合法域名中添加"https://www.baidu.com".

示例代码如下：

//
<button type="primary"bindtap ="getbaidutap">获取 HTML 数据</button>
<textarea value ='{{html}}'auto-heightmaxlength ='0'> </textarea>
//.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
})
}
})
}
})

例如，通过wx.request(0bject)的CET方法获取邮政编码的对应的地址信息。

示例代码：

<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 >
//index.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
})
}
}
})
}
}
})

1.2上传文件
ｗｘ.ｕｐｌｏａｄＦｉｌｅ(Ｏｂｊｅｃｔ)接口用于将本地资源上传到开发者服务器, 并在客户端发起一个ＨＴＴＰＳＰＯＳＴ请求, 其相关参数如表所示。

通过ｗｘ.ｕｐｌｏａｄＦｉｌｅ(Ｏｂｊｅｃｔ), 可以将图片上传到服务器并显示。示例代码：

//index.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="/pages/index/images/ahh.jpg"mode="widthFix"/>

1.3下载文件
ｗｘ.ｄｏｗｎｌｏａｄＦｉｌｅ(Ｏｂｊｅｃｔ)接口用于实现从开发者服务器下载文件资源到本地, 在客户端直接发起一个ＨＴＴＰＧＥＴ请求, 返回文件的本地临时路径。其相关参数如表所示。

例如，通过wx. downloadFile（Object）实现从服务器中下载图片，后台服务采用WAMP软件在本机搭建。示例代码：

//index.js
Page({
data:{
img:null,
},
downloadimage:function(){
var that = this;
wx.downloadFile({
url: "http://localhost/1.jpg", //通过WAMP软件实现
success:function(res){
console.log(res)
that.setData({
img:res.tempFilePath
})
}
})
}
})

<button type="primary" bind:tap="downloadimge">下载图像</button>
<image src="{{img}}"mode='widthFix'style = "width:90%;height:500px"></image>

2.多媒体API
多媒体ＡＰＩ主要包括图片ＡＰＩ、录音ＡＰＩ、音频播放控制ＡＰＩ、音乐播放控制ＡＰＩ等, 其目的是丰富小程序的页面功能。

2.1图片API
图片API实现对相机拍照图片或本地相册图片进行处理，主要包括以下4个API接口：
■ wx.chooseImage（Object）接口用于从本地相册选择图片或使用相机拍照。
■ wx.previewImage（Object）接口用于预览图片。

■ wx.getImageInfo（Object）接口用于获取图片信息。
■ wx.saveImageToPhotosAlbum（Object）接口用于保存图片到系统相册。
1．选择图片或拍照
wx. chooseImage（Object）接口用于从本地相册选择图片或使用相机拍照。拍照时产生的临时路径在小程序本次启动期间可以正常使用，若要持久保存，则需要调用wx. saveFile保存图片到本地。其相关参数如表所示。

若调用成功，则返回tempFilePaths和tempFiles,tempFilePaths表示图片在本地临时文件路径列表。tempFiles表示图片的本地文件列表，包括path和size。

wx.chooseImage({
count:2,//默认值为9
sizeType:['original','compressed'],//可以指定是原图还是压缩图,默认
者都有
sourceType:['album','camera'],//可以指定来源是相册还是相机,默认二者都有
success:function(res){
//返回选定照片的本地文件路径列表,tempFilePath可以作为img标签的src属性来显示图片
var tempFilePaths =res.tempFilePaths
var tempFiles =res.tempFiles;
console.log(tempFilePaths)
console.log(tempFiles)
}
})
1.预览图片
wx. previewImage（Object）接口主要用于预览图片。参数如图所示。

2.获取图片信息
wx. getImageInfo（Object）接口用于获取图片信息.

示例代码:

wx.chooseImage({
success:function(res){
wx.getImageInfo({
src:res.tempFilePaths[0]，
success:function(e){
console.log(e.width)
console.log(e.height)
}
})
}，
})
3.保存图片到系统相册
wx. saveImageToPhotosAlbum（Object）接口用于保存图片到系统相册，需要得到用户授权scope.writePhotosAlbum。

2.2录音API
录音API提供了语音录制的功能，主要包括以下两个API接口：
■ wx.startRecord（Object）接口用于实现开始录音。
■ wx.stopRecord（Object）接口用于实现主动调用停止录音。

1.开始录音
ｗｘ.ｓｔａｒｔＲｅｃｏｒｄ(Ｏｂｊｅｃｔ) 接口用于实现开始录音。当主动调用ｗｘ.ｓｔｏｐＲｅｃｏｒｄ(Ｏｂｊｅｃｔ)接口或者录音超过１分钟时, 系统自动结束录音, 并返回录音文件的临时文件路径。若要持久保存, 则需要调用ｗｘ.ｓａｖｅＦｉｌｅ()接口。其相关参数如表所示。

2.停止录音
wx. stopRecord（Object）接口用于实现主动调用停止录音。

wx.startRecord)
({
success: function(res){
var tempFilePath= res.tempFilePath},
fail: function(res){
//录音失败
}
})
setTimeout(function(){//结束录音
wx.stopRecord()
},10000)
2.3音乐播放控制API
音频播放控制ＡＰＩ主要用于对语音媒体文件的控制, 包括播放、暂停、停止及ａｕｄｉｏ组件的控制, 主要包括以下３个ＡＰＩ:

■ ｗｘ.ｐｌａｙＶｏｉｃｅ(Ｏｂｊｅｃｔ) 接口用于实现开始播放语音。

■ ｗｘ.ｐａｕｓｅＶｏｉｃｅ(Ｏｂｊｅｃｔ) 接口用于实现暂停正在播放的语音。

■ ｗｘ.ｓｔｏｐＶｏｉｃｅ(Ｏｂｊｅｃｔ) 接口用于结束播放语音。

1.播放语音
ｗｘ.ｐｌａｙＶｏｉｃｅ(Ｏｂｊｅｃｔ)接口用于开始播放语音, 同时只允许一个语音文件播放, 如果前一个语音文件还未播放完, 则中断前一个语音文件的播放。

示例代码：

wx.startRecord({
success: function(res){
var tempFilePath= res.tempFilePath wx.playVoice({//录音完后立即播放
filePath:tempFilePath, complete:function(){
}
})
}
})
2.暂停播放
ｗｘ.ｐａｕｓｅＶｏｉｃｅ(Ｏｂｊｅｃｔ) 用于暂停正在播放的语音。再次调用ｗｘ.ｐｌａｙＶｏｉｃｅ(Ｏｂｊｅｃｔ)播放同一个文件时, 会从暂停处开始播放。如果想从头开始播放, 则需要先调用ｗｘ.ｓｔｏｐＶｏｉｃｅ(Ｏｂｊｅｃｔ)。

wx.startRecord({
success: function(res){
var tempFilePath = res.tempFilePath
wx.playVoice({ filePath:tempFilePath
})

setTimeout(function(){
//暂停播放
wx.pauseVoice()},5000)
}
})
3.结束播放
ｗｘ.ｓｔｏｐＶｏｉｃｅ(Ｏｂｊｅｃｔ) 用于结束播放语音。

示例代码：

wx.startRecord({
success: function(res){
var tempFilePath =res.tempFilePath wx.playVoice({
filePath:tempFilePath})

setTimeout(function(){
wx.stopVoice()},5000)
}
})
2.4音乐控制API
音乐播放控制ＡＰＩ主要用于实现对背景音乐的控制, 音乐文件只能是网络流媒体, 不能是本地音乐文件。音乐播放控制ＡＰＩ主要包括以下８个ＡＰＩ:

■ ｗｘ.ｐｌａｙＢａｃｋｇｒｏｕｎｄＡｕｄｉｏ(Ｏｂｊｅｃｔ) 接口用于播放音乐。

■ ｗｘ.ｇｅｔＢａｃｋｇｒｏｕｎｄＡｕｄｉｏＰｌａｙｅｒＳｔａｔｅ(Ｏｂｊｅｃｔ) 接口用于获取音乐播放状态。

■ ｗｘ.ｓｅｅｋＢａｃｋｇｒｏｕｎｄＡｕｄｉｏ(Ｏｂｊｅｃｔ) 接口用于定位音乐播放进度。 ■ ｗｘ.ｐａｕｓｅＢａｃｋｇｒｏｕｎｄＡｕｄｉｏ() 接口用于实现暂停播放音乐。

■ ｗｘ.ｓｔｏｐＢａｃｋｇｒｏｕｎｄＡｕｄｉｏ()

■ ｗｘ.ｏｎＢａｃｋｇｒｏｕｎｄＡｕｄｉｏＰｌａｙ(ＣａｌｌＢａｃｋ) 接口用于实现监听音乐播放。

■ ｗｘ.ｏｎＢａｃｋｇｒｏｕｎｄＡｕｄｉｏＰａｕｓｅ(ＣａｌｌＢａｃｋ) 接口用于实现监听音乐暂停。

■ ｗｘ.ｏｎＢａｃｋｇｒｏｕｎｄＡｕｄｉｏＳｔｏｐ(ＣａｌｌＢａｃｋ) 接口用于实现监听音乐停止。

1.播放音乐
ｗｘ.ｐｌａｙＢａｃｋｇｒｏｕｎｄＡｕｄｉｏ(Ｏｂｊｅｃｔ) 用于播放音乐, 同一时间只能有一首音乐处于播放状态，属性如下：

示例代码：

wx.playBackgroundAudio({
dataUrl:'http://bmob-cdn-16488.b0.upaiyun.com/2018/02/01/ti.mp3',
title:'有一天',
coverImgUrl:'http://bmob-cdn-16488.b0.upaiyun.com/2018/02/01/si.jpg',
success:function(res){
console.log(res)
}
})
2.获取音乐播放状态
ｗｘ.ｇｅｔＢａｃｋｇｒｏｕｎｄＡｕｄｉｏＰｌａｙｅｒＳｔａｔｅ(Ｏｂｊｅｃｔ) 接口用于获取音乐播放状态, 参数如下：

接口调用成功后返回的参数如下：

示例代码：

wx.getBackgroundAudioPlayerState({
success:function(res){
var status=res.status
var dataUrl=res.dataUrl
var currentPosition=res.currentPosition
var duration=res.duration
var downloadPercent=res.downloadPercent
console.log("播放状态："+status)
console.log("音乐文件地址："+dataUrl)
console.log("音乐文件当前播放位置:"+currentPosition)
console.log("音乐文件的长度:"+duration)
console.log("音乐文件的下载进度："+status)
}
})
3.控制音乐播放进度
ｗｘ.ｓｅｅｋＢａｃｋｇｒｏｕｎｄＡｕｄｉｏ(Ｏｂｊｅｃｔ) 接口用于控制音乐播放进度, 参数如下：

wx.seekBackgroundAudio({
posiyion:30
})
4.暂停音乐播放
ｗｘ.ｐａｕｓｅＢａｃｋｇｒｏｕｎｄＡｕｄｉｏ() 接口用于暂停播放音乐。示例代码：

wx.playBackgrondAudio{
dataUrl:'/music/a.mp3',
title:'我的音乐',
coverImgUrl:'/images/poster.jpg',
success:function(){
console.log('开始播放音乐了');
}
});
setTimeout(function(){
console.log('暂停播放');
wx.pauseBackgroundAudio();
},5000);//五秒后自动暂停
5.停止音乐播放
wx. stopBackgroundAudio（）接口用于停止播放音乐，示例代码：

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。

示例代码：

//index.js
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"
}

<view class="container">
<image class="bgaudio"src = "{{changedImg? music.coverImg:'/pages/index/images/ahh.jpg'}}"/>
<view class ="control-view">

<image src ="../index/images/cat.jpg"bindtap="onPositionTap"data-how= "0 "/>
<image src = "../index/images/hh.jpg" bindtap = "onAudioTap"/>
<image src ="../index/images/ddd.jpg"bindtap = "onStopTap"/>
<image src ="../index/images/ahh.jpg"bindtap ="onPositionTap"data-how = "1"/>
</view >
</view >
/**index.wxss**/
.bgaudio{
height:350rpx; width:350rpx;
margin-bottom:100rpx;
}
.control-view image{
height:64rpx;
width:64rpx;
margin:30rpx;
}

3.文件API
从网络上下载或录音的文件都是临时保存的, 若要持久保存, 需要用到文件ＡＰＩ。文件ＡＰＩ提供了打开、保存、删除等操作本地文件的能力, 主要包括以下５个ＡＰＩ接口:

■ ｗｘ.ｓａｖｅＦｉｌｅ(Ｏｂｊｅｃｔ) 接口用于保存文件到本地。

■ ｗｘ.ｇｅｔＳａｖｅｄＦｉｌｅＬｉｓｔ(Ｏｂｊｅｃｔ) 接口用于获取本地已保存的文件列表。

■ ｗｘ.ｇｅｔＳａｖｅＦｉｌｅＩｎｆｏ(Ｏｂｊｅｃｔ) 接口用于获取本地文件的文件信息。

■ ｗｘ.ｒｅｍｏｖｅＳａｖｅＦｉｌｅ(Ｏｂｊｅｃｔ) 接口用于删除本地存储的文件。

■ ｗｘ.ｏｐｅｎＤｏｃｕｍｅｎｔ(Ｏｂｊｅｃｔ) 接口用于新开页面打开文档, 支持格式: ｄｏｃ、ｘｌｓ、ｐｐｔ、ｐｄｆ、ｄｏｃｘ、ｘｌｓｘ、ｐｐｔｓ。

1.保存文件
ｗｘ.ｓａｖｅＦｉｌｅ(Ｏｂｊｅｃｔ)用于保存文件到本地, 其相关参数如表所示。

saveImg:function(){
wx.chooseImage({
count:1,//默认值为9
sizeType:['original','compressed'],//可以指定是原图还是压缩图，默认二者都有
sourceType:['album','camera'],//可以指定来源是相册还是相机，默认二者都有
success:function(res){
var tempFilepaths = res.tempFilePaths[0]
wx.saveFile({
tempFilePath:tempFilePaths,
success:function(res){
var saveFilePath = res.savedFilepath;
console.log(saveFilepath)
}
})
}
})
}

2.获取本地文件列表
wx. getSavedFileList（Object）接口用于获取本地已保存的文件列表，如果调用成功，则返回文件的本地路径、文件大小和文件保存时的时间戳（从1970/01/01 08: 00: 00到当前时间的秒数）文件列表。其相关参数如表所示

示例代码：

wx.getSavedFileList({
success:function(res){
that.setData({
fileList:res.fileList
})
}
})
3.获取本地文件的文件信息
wx. getSaveFileInfo（Object）接口用于获取本地文件的文件信息，此接口只能用于获取已保存到本地的文件，若需要获取临时文件信息，则使用wx. getFileInfo（Object）接口。其相关参数如表所示。

示例代码:

4.删除本地文件
wx. removeSaveFile（Object）接口用于删除本地存储的文件，其相关参数如表所示。

从文件列表删除第一个文件，示例代码:

wx.getSavdFileList({
success:function(res){
if(res.fileList.length > 0){
wx.removeSavedFile({
filePath:res.fileList[0].filePath,
complete:function(res){
console.log(res)
}
})
}
}
})
5.打开文档
ｗｘ.ｏｐｅｎＤｏｃｕｍｅｎｔ(Ｏｂｊｅｃｔ)接口用于新开页面打开文档, 支持格式有ｄｏｃ、ｘｌｓ、ｐｐｔ、ｐｄｆ、ｄｏｃｘ、ｘｌｓｘ、ｐｐｔｘ, 其相关参数如表所示。

示例代码：

wx.downloadFile({
url:"http://localhost/fm2.pdf",//在本地通过wxamp搭建服务器
success:function(res){
var tempFilePath = res.tempFilePath:
wx.openDochument({
filePath:tempFilePath,
success:function(res){
console.log("打开成功")
}
)}
}
)}
4.本地数据及缓存API
小程序提供了以键值对的形式进行本地数据缓存功能, 并且是永久存储的, 但最大不超过１０ＭＢ, 其目的是提高加载速度。数据缓存的接口主要有４个:

■ ｗｘ.ｓｅｔＳｔｏｒａｇｅ(Ｏｂｊｅｃｔ) 或ｗｘ.ｓｅｔＳｔｏｒａｇｅＳｙｎｃ(ｋｅｙ,ｄａｔａ) 接口用于设置缓存数据。

■ ｗｘ.ｇｅｔＳｔｏｒａｇｅ(Ｏｂｊｅｃｔ) 或ｗｘ.ｇｅｔＳｔｏｒａｇｅＳｙｎｃ(ｋｅｙ) 接口用于获取缓存数据。

■ ｗｘ.ｒｅｍｏｖｅＳｔｏｒａｇｅ(Ｏｂｊｅｃｔ) 或ｗｘ.ｒｅｍｏｖｅＳｔｏｒａｇｅＳｙｎｃ(ｋｅｙ) 接口用于删除指定缓存数据。

■ ｗｘ.ｃｌｅａｒＳｔｏｒａｇｅ() 或ｗｘ.ｃｌｅａｒＳｔｏｒａｇｅＳｙｎｃ() 接口用于清除缓存数据。其中, 带Ｓｙｎｃ后缀的为同步接口, 不带Ｓｙｎｃ后缀的为异步接口。

4.1保存数据
１.ｗｘ.ｓｅｔＳｔｏｒａｇｅ(Ｏｂｊｅｃｔ) ｗｘ.ｓｅｔＳｔｏｒａｇｅ(Ｏｂｊｅｃｔ)接口将数据存储到本地缓存接口指定的ｋｅｙ中, 接口执行后会覆盖原来ｋｅｙ对应的内容。其参数如表所示。

2.ｗｘ.ｓｅｔＳｔｏｒａｇｅＳｙｎｃ(ｋｅｙ,ｄａｔａ) ｗｘ.ｓｅｔＳｔｏｒａｇｅＳｙｎｃ(ｋｅｙ,ｄａｔａ)是同步接口, 其参数只有ｋｅｙ和ｄａｔａ。

示例代码：

wx.setStorage({
key:'name',
data:'sdy',
success:funaction(res){
console.log(res)
}
})
4.2获取数据
１.ｗｘ.ｇｅｔＳｔｏｒａｇｅ(Ｏｂｊｅｃｔ) ｗｘ.ｇｅｔＳｔｏｒａｇｅ(Ｏｂｊｅｃｔ) 接口是从本地缓存中异步获取指定ｋｅｙ对应的内容。其相关参数如表所示。

示例代码：

wx.getstorage({ key:'name',
success:function(res){
console.log(res.data)
},
})
２.ｗｘ.ｇｅｔＳｔｏｒａｇｅＳｙｎｃ(ｋｅｙ)ｗｘ.ｇｅｔＳｔｏｒａｇｅＳｙｎｃ(ｋｅｙ)从本地缓存中同步获取指定ｋｅｙ对应的内容。其参数只有ｋｅｙ。

try{
var value = wx.getstorageSync('age')
if(value){
console.log("获取成功"+value)
}
catch(e){
console.log("获取失败")
}
4.3删除数据
1. wx. removeStorage（Object）
wx. removeStorage（Object）接口用于从本地缓存中异步移除指定key。参数如表所示：

示例代码：

wx.removeStorage({
key:'name',
success:function(res){ console.log("删除成功")
},
fail:function(){
console.log("删除失败")
}

})
2. wx. removeStorageSync（key）
wx. removeStorageSync（key）接口用于从本地缓存中同步删除指定key对应的内容。其参数只有key。示例代码：

try {
wx.removeStorageSync('name')
} catch(e){
//Do something when catch error
}
4.4 清空数据
1. wx. clearStorage（）
wx. clearStorage（）接口用于异步清理本地数据缓存，没有参数。

示例代码：

wx.getStorage({
key:'name',
success:function(res){
wx.clearStorage()
},
})
2.wx.clearStroageSync()

wx.clearStroageSync()接口用于同步清理本地数据缓存。

示例代码

try{
wx.clearStorageSync()
}catch(e){
}
5.位置信息API
小程序可以通过位置信息ＡＰＩ来获取或显示本地位置信息, 小程序支持ＷＧＳ８４和ＧＣｊ０２标准, ＷＧＳ８４标准为地球坐标系, 是国际上通用的坐标系ꎻ ＧＣｊ０２标准是中国国家测绘局制定的地理信息系统的坐标系统, 是由ＷＧＳ８４坐标系经加密后的坐标系, 又称为火星坐标系。默认为ＷＧＳ８４标准, 若要查看位置需要使用ＧＣｊ０２标准。主要包括以下３个ＡＰＩ接口:

■ ｗｘ.ｇｅｔＬｏｃａｔｉｏｎ(Ｏｂｊｅｃｔ) 接口用于获取位置信息。

■ ｗｘ.ｃｈｏｏｓｅＬｏｃａｔｉｏｎ(Ｏｂｊｅｃｔ) 接口用于选择位置信息。

■ ｗｘ.ｏｐｅｎＬｏｃａｔｉｏｎ(Ｏｂｊｅｃｔ) 接口用于通过地图显示位置

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);},
})
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号'})
}
})
5.3显示位置API
wx.openLocation(Object)接口用于在微信内置地图中显示位置信息，其相关参数如表所示

示例代码：

wx.getLocation({
type:'gcj02',
success:function(res){
var latitude =res.latitude
var longitude =res.longitude
wx.openLocation({
latitude: latitude,
longitude: longitude,
scale:10,
name:'智慧国际酒店',
address:'西安市长安区西长安区300号'
})
}
})
6.设备相关API
设备相关的接口用于获取设备相关信息，主要包括系统信息、网络状态、拨打电话及主
码等。主要包括以下5个接口API：
■ wx. getSystemInfo(Object)接口、wx.getSystemInfoSyne()接口用于获取系统信息
■ wx. getNetworkType(Object)接口用于获取网络类型。
■ wx.onNetworkStatusChange(CallBack)接口用于监测网络状态改变。
■ wx.makePhoneCall(Object)接口用于拨打电话。
■ wx.scanCode(Object)接口用于扫描二维码。

6.1获取系统信息
wx. getSystemInfo（Object）接口、wx. getSystemInfoSync（）接口分别用于异步和同步获取系统信息。参数如下：

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.2网络状态
1.获取网络状态
wx. getNetworkType（Object）用于获取网络类型，参数如下

如果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.3拨打电话
wx. makePhoneCall（Object）接口用于实现调用手机拨打电话，参数如下：

示例代码：

wx.makePhoneCall({
phoneNumber:'14797956155'//需要拨打的电话号码
})

6.4扫描二维码
wx. scanCode（Object）接口用于调起客户端扫码界面，扫码成功后返回相应的内容，参数如下：

扫码成功后，返回的数据如表所示。

示例代码：

//允许从相机和相册扫码
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)
}
})