微信小程序(1~6)章总结

最新推荐文章于 2024-05-02 14:54:59 发布

2201_75484561

最新推荐文章于 2024-05-02 14:54:59 发布

阅读量469

点赞数 4

文章标签：微信小程序小程序

本文链接：https://blog.csdn.net/2201_75484561/article/details/138176364

版权

第一章微信小程序概述

1.认识微信小程序

简介：小程序是一种轻量级的应用程序，通常用于在移动设备上提供特定功能或服务。它们类似于手机应用程序，但不需要用户下载和安装，可以直接在支持的平台上运行。小程序通常由HTML、CSS和JavaScript等前端技术开发，可以在微信、支付宝、百度等平台上运行。
特征：
1.无须安装

小程序内嵌于微信程序之中，用户在使用过程中无须在应用商店下载安装外部应用。

2.触手可及

用户通过扫描二维码等形式直接进入小程序，实现线下场景与线上应用的即时联通。

3.用完即走

用户在线下场景中，当有相关需求时，可以直接接入小程序，使用服务功能后便可以对其不理会，实现用完即走。

4. 无须卸载

用户在访问小程序后可以直接关闭小程序，无须卸载。

2.我的第一个微信小程序

首先创建项目需要项目名和目录地址尾部需要一致，在填写创建好的APPID即可。创建完项目我们把微信小程序开发者工具界面划分五大区域：菜单栏、工具栏、模拟器、代码编辑区和调试区。

第二章微信小程序开发基础

2.1小程序的开发框架

通过框架图我们可以看到两大部分：
■在页面视图层，wxml是MINA提供的一套类似于HTML标签的语言以及一系列基础组件。开发者使用wxml文件来搭建页面的基本视图结构，使用wxss文件来控制页面的展现样式。
■AppService应用逻辑层是MINA的服务中心，由微信客户端启用异步线程单独加载运行。页面渲染所需的数据、页面交互处理逻辑都在AppService中实现。

MINA框架为页面组件提供了bindtap、bindtouchstart等事件监听相关的属性，来与AppService中的事件处理函数绑定在一起，实现页面向AppService层同步用户交互数据。

框架的核心是一个响应的数据绑定系统，它让数据与视图非常简单地保持同步。当做数据修改的时候，只需要在逻辑层修改数据，视图层就会做相应的更新。

结构层
逻辑层
微信小程序在逻辑层将数据进行处理后发送给视图层，同时接受视图层的事件反馈。

视图层
框架的视图层由WXML（WeiXin Markup language）与WXSS（WeiXin Style Sheet）编写，由组件来进行展示。于微信小程序而言，视图层就是所有．wxml文件与．wxss文件的集合。

数据层
数据层包括临时数据或缓存、文件存储、网络存储与调用。

1．页面临时数据或缓存
在Page()中，我们要使用setData函数来将数据从逻辑层发送到视图层，同时改变对应的this.data的值。

2．文件存储（本地存储）
使用数据API接口，如下所示：
■wx.getStorage：获取本地数据缓存。
■wx.setStorage：设置本地数据缓存。
■wx.clearStorage：清理本地数据缓存。

3．网络存储或调用
上传或下载文件API接口，如下：
■wx.request：发起网络请求。
■wx.uploadFile：上传文件。
■wx.downloadFile：下载文件。

2.2 创建小程序页面

2.2.1创建一个新的页面文件

打开app.json文件，输入以下代码

{
  "pages":[
    "pages/news/news",
    "pages/index/index"
  ]
}

假设，我们的目的是页面显示“欢迎学习小程序开发” ，首先，打开news.wxml文件输入以下代码

<text>欢迎学习小程序开发</text>

2.3配置文件

2.3.1全局配置文件

小程序的全局配置文件保存在全局配置文件（app.js）中，使用全局配置文件来配置页面文件（pages）的路径，设置窗口（window）表现，设定网络请求API超时时间值（networkTimeout）以及配置多个切换页（tabBar）等。

全局配置文件内容的整体结构如下：

{
//设置页面路径
"pages":[],
//设置默认页面的窗口表现
"window":{},
//设置底部tab的表现
"tabBar":{},
//设置网络请求API的超时时间值
"networkTimeout":{},
//设置是否开启debug模式
"debug":false
}

1.pages配置项

pages配置项接受一个数组，用来指定小程序由哪些页面组成，数组的每一项都是字符串，代表对应页面的“路径”+“文件名”。pages配置项是必填项。
设置pages配置项时，应注意以下3点：
(1)数组的第一项用于设定小程序的初始页面。
(2)在小程序中新增或减少页面时，都需要对数组进行修改。
(3)文件名不需要写文件扩展名。小程序框架会自动寻找路径及对.js、.json.wxml和.wxss文件进行整合数据绑定。

app.json文件的配置如下：

{
  "pages": [
    "pages/news/news",
    "pages/index/index",
  ]
}

2. window 配置项

window配置项负责设置小程序状态栏、导航条、标题、窗口背景色等系统样式。

window配置项及描述

在app.json中设置如下window配置项：

"window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "Weixin",
    "navigationBarBackgroundColor": "#ffffff"
    "backgroundColor": "#ccc"
    "backgroundTextStyle": "light"
  }

3. tabBar配置项

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

tabBar配置项及其描述

tabBar中list选项

在app.json中设置如下tabBar配置项：

"tabBar":{
    "co1or":"#666666",
    "selectedCclor":"#ff0000",
    "borderstyle":"black",
    "backgroundColor":"#ffffff",
    "list":[
    {
    "pagePath":"pages/index/index",
    "iconPath":"./img/R-C.png",
    "selectedIconPath":"./img/R-C.png",
    "text":"首页"
    },
    {
    "pagePath":"pages/news/news",
    "iconPath":"./img/feel.jpg",
    "selectedIconPath":"./img/feel.jpg",
    "text":"新闻"
    }
    ]
  },

4.networkTimeout配置项

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

networkTimeout配置项

例如，为提高网络响应效率，开发者可以在app.json中使用下列超时设置：

{
"networkTimeout":{
"request":20000,
"connectSocket":20000,
"uploadFile":20000,
"downloadFile":20000
}
}

2.3.2页面配置文件

页面配置文件(*.json)只能设置本页面的窗口表现，而且只能设置window配置项的内容。在配置页面配置文件后，页面中的window配置值将覆盖全局配置文件(app.json)中的配置值。
页面中的 window 配置只需书写配置项，不必书写 window，代码示例如下:

 "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "Weixin",
    "navigationBarBackgroundColor": "#ffffff"
    "backgroundColor":"#eeeeee",
    "backgroundTextStyle":"light"
  },

2.4逻辑层文件

2.4.1项目逻辑文件

项目逻辑文件 app.js中可以通过App()函数注册小程序生命周期函数、全局属性和全局方法，已注册的小程序实例可以在其他页面逻辑文件中通过getApp()获取。
App()函数用于注册一个小程序，参数为Object，用于指定小程序的生命周期函数、用户自定义属性和方法，其参数如表所示。

项目逻辑文件配置项

代码示例

APP({
//当小程序初始完成时，会触发onLaunch(全局只触发一次)
onLaunch:funtion(){
console.log("小程序初始化完成......")
},
//当小程序启动(或从后台进入前台显示)时会触发onShow
onShow:funtion(options){
console.log("小程序显示")
console.log("this.date")
console.log("this.fun")
},
//当小程序从前台进入后台，会触发onHide
onHide:function(){
console.log("小程序进入后台")
}，
//当小程序发生脚本错误，或者API调用失败时，会触发onError并带上错误信息
onError:function(msg){
},
//自定义方法
fun:funtion(){
console.log("在app.js中定义的方法");
},
//自定义属性
data:'在app.js中定义的属性'
})

2.4.2页面逻辑文件

页面逻辑文件的主要功能有：设置初始数据；定义当前页面的生命周期函数；定义事件处理函数。

在逻辑层，Page()方法用来注册一个页面，并且每个页面有且仅有一个，其参数如表所示。

数据初始

Page({
 
  /**
   * 页面的初始数据
   */
  data: {
    name:'lwk',//字符串
    age:30,//数字
    birthday:[{year:1988},{month:11},{date:18}],//数组
    object:{hobby:'computer'},//对象  
  })
数据绑定

<view>姓名：{{name}}</view>
<view>年龄：{{age}}</view>
<view>出生日期：
{{birthday[0].year}}年
{{birthday[1].month}}月
{{birthday[2].date}}日
</view>
<view>爱好：{{object.hobby}}</view>

2.5页面结构文件

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

<!--pages/news/news.wxml-->
<!-- 数据简单绑定 -->
<view>姓名：{{name}}</view>
<view>年龄：{{age}}</view>
<view>出生日期：
{{birthday[0].year}}年
{{birthday[1].month}}月
{{birthday[2].date}}日
</view>
<view>爱好：{{object.hobby}}</view>
<!-- 运算 -->
<view>算数运算：{{age+num}}</view>
<view>逻辑运算:{{age==40}}</view>
<view>三元运算：{{age==1?3:num}}</view>
<!-- 条件数据绑定 -->
<view wx:if="age>40">1</view>
<view wx:elif="age==40">2</view>
<view wx:else>3</view>
<!-- 列表数据绑定 -->
<view wx:for="{{students}}">
<text>姓名：{{item.nickname}}</text>
<text>身高：{{item.height}}</text>
<text>体重：{{item.weight}}</text>
</view>
<!-- 模板 -->
<template name="stu">
<view wx:for="{{students}}">
<text>姓名：{{item.nickname}}</text>
<text>身高：{{item.height}}</text>
<text>体重：{{item.weight}}</text>
</view>
</template>
<template is="stu" data="{{students}}"></template>

数据

// pages/news/news.js
Page({
 
  /**
   * 页面的初始数据
   */
  data: {
    name:'lwk',//字符串
    age:30,//数字
    num:100,
    birthday:[{year:1988},{month:11},{date:18}],//数组
    object:{hobby:'computer'},//对象
    students:[
      {
        nickname:"Tom",height:180,weight:150
      },
      {nickname:"Jack",height:190,weight:155}
    ]
    
  }
})

运行效果及结果

在小程序中，事件分为冒泡事件和非冒泡事件两大类型
冒泡事件 冒泡事件是指某个组件上的事件被触发后，事件会向父级元素传递父级元素再向其父级元素传递，一直到页面的顶级元素。
非冒泡事件 非冒泡事件是指某个组件上的事件被触发后，该事件不会向节点传递。

冒泡事件

2.6页面样式文件

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

1.尺寸单位

由于 CSS原有的尺寸单位在不同尺寸的屏幕中得不到很好的呈现，WXSS 在此基础上增加了尺寸单位 rpx。1rpx=0.5px。

2.样式导入

为了便于管理 WXSS 文件，我们可以将样式存放于不同的文件中。如果需要在某个文件中引用另一个样式文件，使用@import 语句导入即可。例如：

//a. wxss
.cont{border:lpx solid #f00;}
//b.wxss
@ import"a.wxss;"
.cont{padding:5rpx; margin;5px;}
//以上代码的效果与下列代码的效果相同:
//b. wxss
.cont{border:lpx solid #f00 ;
Padding:5px;marwgin:5px;}

3.选择器

目前，WXSS 仅支持 CSS 中常用的选择器，如:class、#id、element、::before、::aftert 等.

4.WXSS常用属性

第三章页面布局

3.1 盒子模型

3.1.2盒子模型元素

图中各元素的含义如下：

width和height:内容的宽度和高度。
padding -top、padding-right、padding-bottom 和padding-left 上内边距、右内边距、底内边距和左内边距。
border-top、border-rght、border -bottom和border -left 上边框、右边框、底边和左边框。
margin -top、margin-right、margin-bottom和margin-left上外边距、外边底外边距和左外边距

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

3.2块级元素与行内元素

元素按显示方式分为块级元素、行内元素和行内块元素，它们的显示方式由display属性控制。

3.2.1 块级元素

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

<!-- 块级元素 -->
<view style="border:1px solid #f00">块级元素1</view>
<view style="border:1px solid #f00;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 style="height: 60px;">块级元素4</view></view>
<view style="border:1px solid #f00;width:100px;background-color: #ccc;">父级元素高度随内容决定，内容为文本</view>

运行效果图

3.2.2行内元素

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

(1)行能被设置高度和宽度，其高度和宽度由内容决定。内元素不

(2)行内元素内不能放置块级元素，只级容纳文本或其他行内元素
(3)同一块内，行内元素和其他行内元素显示在同一行。
<text/>组件默认为行内元素，使用<view/>及<text/>组件演示盒子模型及行内的示例代码如下:

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

3.2.3行内块元素

当元素的 display属性被设置为inline-block 时，元素被设置为行内块元素。行内块元素可以被设置高度、宽度、内边距和外边距。示例代码如下:

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

运行效果图：

3.3浮动与定位

3.3.1元素浮动与清除

元素浮动就是指设置了浮动属性的元素会脱离标准文档流的控制，移到其父元素中指定位置的过程。在CSS中，通过foat属性来定义浮动，其基本格式如下:

{float:none |left |lright;}

其中，none--默认值，表示元素不浮动;
lef--元素向左浮动;
right--元素向右浮动。
在下面的示例代码中，分别对box1、box2、box3元素左浮动:

<!--pages/news/news.wxml-->
<veiw>box1,box2,box3没浮动</veiw>
<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>
<veiw>box1左浮动</veiw>
<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>
<veiw>box1,box2左浮动</veiw>
<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>
<veiw>box1,box2,box3左浮动</veiw>
<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="float: left;border: 1px solid #0f0;">box3</view>
</view>

运行效果图：

由于浮动元素不再占用原文档流的位置，因此它会对页面中其他元素的排外产生影响在CSS中，clear属性用于清除浮动元素对其他元素的影响，其基本格式如下：

{clear:left|right|both|none}

其中，left--清除左边浮动的影响，也就是不允许左侧有浮动元素;

right--清除右边浮动的影响，也就是不允许右侧有浮动元素;
both--同时清除左右两侧浮动的影响;
none---不清除浮动.
示例代码如下:

<!--pages/gars/gars.wxml-->
<!--清除浮动-->
<veiw>box1,box2左浮动,box3清除左浮动</veiw>
<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>


<!--添加一个空元素-->
<veiw>box1,box2,box3左浮动 在父元素后添加一个空元素</veiw>
<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="float: left; border: 1px solid #0f0;">box3</view>
</view>
/* pages/gars/gars.wxss */
.clearfloat::after{display: block;clear: both;height: 0;content: ""}

3.3.2元素定位

浮动布局虽然灵活，但无法对元素的位置进行精确的控制。在CSS中，通过posiion属性可以实现对页面元素的精确定位。基本格式如下:

{position:static|relative|absolute|fixed}

其中，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进行元素相对定位，示例代码如下:

<!-- box2元素相对定位relative<top:30px;left:30px -->
<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进行元素绝对定位，示例代码如下:

<!-- box2元素绝对定位absolute top:30px;left:30px -->
<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进行元素固定位，示例代码如下:

<!-- box2元素固定定位fixed top:30px;left:30px -->
<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>

元素代码从下往下对应从左往右运行效果图：

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

<!-- 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: 30px;">box2</view>
<view style="border:1px solid #0f0;width: 100px;height: 100px;">box3</view>
</view>

如果将box1、box2、box3的父元素采用相对定位，将box2采用固定定位，代码如下:

<!-- 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: fixed;left: 30px;top: 30px;">box2</view>
<view style="border:1px solid #0f0;width: 100px;height: 100px;">box3</view>
</view>

运行效果图:

3.4flex布局

flex布局是万维网联盟(World Wide WebConsortium，W3C)在2009年提出的一种新布局方案，该布局可以简单快速地完成各种可以伸缩的设计，以便很好地支持响应式布局。flex是flexible box 的缩写，意为弹性盒子模型，可以简便、完整、响应式地实现各种页面布局。

3.4.1容器属性

flex容器支持的7种属性

1.display

display用来指定元素是否为flex布局，语法格式为：

.box{display:flex|inline-flex;}

设置了flex布局之后，子元素的float，clear和vertical-align属性将失效

属性值及描述：

2.flex-direction

flex-direction用于设置主轴的方向，即项目排列的方向，语法格式为：

.box { flex-direction: row | row-reverse | column | column-reverse;}

flex-direction性值及描述：

flex-direction不同值得显示效果图：

3.flex-wrap

flex-wrap用于指定当项目在一根轴线的排列位置不够时,项目是否换行，语法格式为：

.box { flex-wrap: nowrap | wrap | wrap-reverse;}

flex-wrap属性值及描述：

4.flex-flow

flex-flow是flex- flex-direction和flex-warp的简写形式，默认值为row nowrap,语法格式为：

.box {
  flex-flow: <flex-direction> || <flex-wrap>;
}

示例代码如下:

.box{flex-flow:row nowrap;}//水平方向不换行
.box{flex-flow:row-reverse wrap;}//水平方向逆方向换行
.box{flex-flow:row nowrap;}//垂直方向逆方向换行

5.justifty-content

justtify-content用于定义项目在主轴上的对齐方式。语法格式如下：

.box {
  justify-content: flex-start | flex-end | center | space-between | space-around;
}

justtify-content——与主轴方向有关，默认主轴水平对齐，方向从左到右；

justtify-content属性值及描述：

justtify-content不同值显示效果图

6.align-items

align-items用于指定项目在交叉轴上的对齐方式。语法格式如下：

.box {
  display: flex;
  align-items: flex-start | flex-end | center | baseline | stretch;
}

align-items 属性值及描述：

示例代码如下：

//.wxml
<!-- align-items -->
<view class="contl">
<view class="item">1</view>
<view class="item item2">2</view>
<view class="item item3">3</view>
<view class="item item4">4</view>
</view>
//.wxss
.contl{
    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;
}

7.align-content

用来定义项目有多根轴线，(出现换行后)在交叉轴上的对齐方式，如果只有一根轴线，该属性不起作用。语法格式如下：

.container {
  display: flex;
  align-content: flex-start | flex-end | center | space-between | space-around | stretch;
}

align-content属性值及描述：

align-content不同值显示效果图

3.4.2项目属性

容器内项目支持6个属性其名称和功能表

1.order

定义项目的排列顺序。数值越小，排列越靠前，默认为0,语法格式如下：

.item {
  order: <number>;
}

示例代码如下：

//.wxml
<!-- order -->
<view class="contl">
<view class="item">1</view>
<view class="item">2</view>
<view class="item">3</view>
<view class="item">4</view>
</view>
<view class="contl">
<view class="item" style="order: 1">1</view>
<view class="item" style="order: 3">2</view>
<view class="item" style="order: 2">3</view>
<view class="item">4</view>
</view>
//.wxss
.contl{
    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;
}

运行效果图：

2.flex-grow

设置项目的放大比例, 默认为0: 不放大,哪怕轴上有剩余空间,语法格式如下：

.item {
  flex-grow: <number>; /* default: 0 */
}

示例代码：

//.wxml
<view class="contl">
<view class="item">1</view>
<view class="item">2</view>
<view class="item">3</view>
<view class="item">4</view>
</view>
<view class="contl">
<view class="item">1</view>
<view class="item" style="flex-grow: 1">2</view>
<view class="item" style="flex-grow: 2">3</view>
<view class="item" >4</view>
</view>
//.wxss
.contl{
    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.flex-shrink

设置了项目的缩小比例,默认为1, 即空间不足时, 自动缩小填充,语法格式如下：

.item {
  flex-shrink: <number>; /*defautl: 1*/
}

示例代码:

//.wxml
<!-- flex-shrink -->
<view class="contl">
<view class="item">1</view>
<view class="item">2</view>
<view class="item">3</view>
<view class="item">4</view>
</view>
<view class="contl">
<view class="item">1</view>
<view class="item" style="flex-shrink: 2">2</view>
<view class="item" style="flex-shrink: 1">3</view>
<view class="item" style="flex-shrink: 4">4</view>
</view>
//.wxss
.contl{
    display: flex;
    flex-direction: row;
    align-items: baseline;
}
.item{
    background-color: #ccc;
    border: 1px solid #f00;
    height: 50px;
    width: 100px;
    margin: 2px;
}
.item2{
    height: 80px;
}
.item3{
    display: flex;
    height: 50px;
    align-items: flex-end;
}
.item4{
    height: 120px;
}

运行效果图：

4.flex-basis

定义了在计算分配主轴上剩余空间之前, 项目占据的主轴空间(main size)
- 浏览器根据该属性,可以计算出主轴上是否还有剩余空间, 决定是否换行
- 默认值为auto, 即项目原来占据的空间大小

.item {
  flex-basis: length | auto; /* default auto */
}

示例代码如下：

//.wxml
<!-- flex-basis -->
<view class="contl">
<view class="item">1</view>
<view class="item">2</view>
<view class="item">3</view>
<view class="item">4</view>
</view>
<view class="contl">
<view class="item">1</view>
<view class="item" style="flex-basis: 100px">2</view>
<view class="item" style="flex-basis: 200px">3</view>
<view class="item" >4</view>
</view>
//.wxss
.contl{
    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;
}

运行效果图：

5.flex

flex属性是前面flex-grow,flex-shrink和flex-basis属性的简写
默认值: 0 1 auto, 除第一个外, 其它二个可选
语法格式如下：

.item {
  flex: none | [ <'flex-grow'> <'flex-shrink'>? || <'flex-basis'> ]
}

示例代码如下

.item{flex:auto;}//等价于.item{flex: 1 1 auto}
.item{flex:none;}//等价于.item{flex: 0 0 auto}

6.align-self

该属性允许单个项目有与其它项目不一样的对齐方式, 可覆盖掉容器的flex-items属性
默认值: auto,表示继承父元素的align-items,如果没有父元素,则等价于stretch
语法格式如下

.item {
  align-self: auto | flex-start | flex-end | center | baseline | stretch;
}

第四章页面组件

4.1组件的定义及属性

组件是页面视图层(WXML)的基本组成单元，组件组合可以构建功能强大的页面结构。小程序框架为开发者提供了容器视图、基础内容、表单、导航、多媒体、地图、画布、开放能力等8类(30多个)基础组件。

每一个组件都由一对标签组成，有开始标签和结束标签，内容放置在开始标签和结束标签之间，内容也可以是组件。组件的语法格式如下:

<标签名 属性名=”属性值”>内容…</标签名>

组件通过属性来进一步细化。不同的组件可以有不同的属性，但它们也有一些共用属性，如id、class、style、hidden、data-*、bind */catch*等。

id 组件的唯一表示，保持整个页面唯一，不常用。
class 组件的样式类，对应 WXSS 中定义的样式。
style 组件的内联样式，可以动态设置内联样式。
hidden 组件是否显示，所有组件默认显示。
data-* 自定义属性，组件触发事件时，会发送给事件处理函数。事件处理函数可以通过传入参数对象的currentTarget.dataset方式来获取自定义属性的值。
bind*/catch* 组件的事件，绑定逻辑层相关事件处理函数。

4.2容器视图组件

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

4.2.1View

view 组件是块级组件，没有特殊功能，主要用于布局展示，相当于HTML中的div，是布局中最基本的用户界面(User Interface，UI)组件，通过设置 view 的CSS 属性可以实现各种复杂的布局。view组件的特有属性如表所示。

view组件的特有属性

通过<view>组件实现页面布局示例代码如下：

<!--pages/zujian/zujian.wxml-->
<view style="text-align: center;">默认flex布局</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;flex-grow: 1;">1</view>
<view style="display: flex;">
<view style="border: 1px solid #f00;flex-grow: 1;">2</view>
<view style="border: 1px solid #f00;flex-grow: 1;">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: 1px solid #f00;flex-grow: 1;">2</view>
<view style="border: 1px solid #f00;flex-grow: 1;">3</view>
</view>
</view>

view组件示例效果图

4.2.2Scroll-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组件。这样做，能通过单击顶部状态栏回到页面顶部。

通过 scroll-view组件可以实现下拉刷新和上拉加载更多，代码如下:

scroll-view.wxml

<!--pages/scroll/scroll.wxml-->
<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}}" />
<view class="text">
<text class="title">{{item.name}}</text>
<text class="description">{{item.short_de_scription}}</text>
</view>
</view>
</scroll-view>
<view class="body-view">
<loading hidden="{{hidden}}"bindchange="loadingChange">加载中...</loading>
</view>
</view>

scroll-view.js

var url="http://www.imooc.com/course/ajaxlist";
var page=0;
var page_size=5;
var sort="last";
var is_easy=0;
var lange_id=0;
var pos_id=0;
var unlearn=0;
//请求数据
var loadMore=function(that){
    that.setData({
        hidden:false
    });
    wx.request({
      url: 'url',
      data:{
          page:page,
          page_size:page_size,
          sort:sort,
          is_easy:is_easy,
          lange_id:lange_id,
          pos_id:pos_id,
          unlearn:unlearn
      },
      success:function(res){
          //console.info(that.data.list);
          var list =that.data.list;
          for(var i=0;i<res.data.list.lenght;i++){
              list.push(res.data.list[i]);
          }
          that.setData({
              list:list
          });
          page++;
          that.setData({
              hidden:true
          });
      }
    });
}
Page({
    data:{
        hidden:true,
        list:[],
        scrollTop:0,
        scrollHeight:0
    },
    onLoad:function(){
        //这里要注意，微信的scrll-view必须设置高度才能监听滚动事件，所以需要在页
       // 面的onLoad事件中为scroll-view的高度赋值
       var that=this;
       wx.getSystemInfo({
           success:function(res){
               that.setData({
                   scrollHeight: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");
    }
})

scroll-view.wxss

/* pages/scroll/scroll.wxss */
.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;
}

4.2.3Swiper

swiper 组件可以实现轮播图、图片预览、滑动页面等效果。一个完整的swiper 组件由<swiper/>和<swiper -item/>两个标签组成，它们不能单独使用。<swiper/>中只能放置一个或多个<swiper -item/>，若放置其他组件则会被删除;<swiper-item/>内部可以放置任何组件，默认宽高自动设置为100%。swiper组件的属性如表4-3所示。

swiper组件属性

<swiper indicator-dots="true"autoplay="true"interval="5000"duration="1000">
<swiper-item>
<image src="img/pic01.jpg"style="width:100%"></image>
</swiper-item>
<swiper-item>
<image src="img/bestseller2.jpg"style="width:100%"></image>
</swiper-item>
<swiper-item>
<image src="img/pic02.jpg"style="width:100%"></image>
</swiper-item>
</swiper>

运行效果图

4.3基础内容组件

4.3.1icon

示例代码如下：

<!--pages/icon/icon.wxml-->
<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>
// pages/icon/icon.js
Page({
  data: {
      iconType:[
          "success","success_on_circle","info","warn","wait_ing","cancel","download","search","clear"
      ],
      iconSize:[10,20,30,40],
      iconColor:['#f00','#0f0','#00f']
  },
})

运行效果图：

4.3.2text

示例代码如下：

<!--pages/text/text.wxml-->
<block wx:for="{{x}}"wx:for-item="x">
<view class="aa">
<block wx:for="{{29-x}}"wx:for-item="x">
<text decode="{{true}}"space="{{true}}">&nbsp;</text>
  </block>
<block wx:for="{{y}}"wx:for-item="y">
<block wx:if="{{y<=2*x-1}}">
<text>*</text>
</block>
</block>
</view>
</block>
<block wx:for="{{x}}"wx:for-item="x">
<view class="aa">
<block wx:for="{{23+x}}"wx:for-item="x">
<text decode="{{true}}"space="{{true}}">&nbsp;</text>
</block>
<block wx:for="{{y}}"wx:for-item="y">
<block wx:if="{{y<=11-2*x}}">
<text>*</text>
</block>
</block>
</view>
</block> 
// pages/text/text.js
Page({
  data: {
x:[1,2,3,4,5],
y:[1,2,3,4,5,6,7,8,9]
  },
})

运行效果图:

4.3.3progress

示例代码如下：

<!-- 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表单组件

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

4.4.1button

button 组件用来实现用户和应用之间的交互，同时按钮的颜色起引导作用。一般来说在一个程序中一个按钮至少有3种状态:默认点击(defaut)、建议点击(primary)、谨慎点击(wam)。在构建项目时，应在合适的场景使用合适的按钮，当<button>被<form/>包裹时，可以通过设置fomm-type属性来触发表单对应的事件。button组件的属性如表所示。

button组件的属性

示例代码如下：

<!--pages/button/button.wxml-->
<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>
// pages/button/button.js
Page({

  /**
   * 页面的初始数据
   */
  data: {
size:'default',
plain:'false',
loading:'false'
  },
  //改变按钮大小
  buttonSize:function(){
      if(this.data.size=="default")
      this.setData({size:'mini'})
      else
      this.setData({size:'default'})
  },
  //是否显示镂空
  buttonPlain:function(){
      this.setData({plain:!this.data.plain})
  },
  //显示loading图案
  buttonLoading:function(){
    this.setData({loading:!this.data.loading})
  }
})

运行效果图：

4.4.2radio

单选框用来从一组选项中选取一个选项，在小程序中，单选框由<radio-group/>(单项选择器)和<radio/>(单选项目)两个组件组合而成，一个包含多个<radio/>的<radio-group/>表示一组单选项，在同一组单选项中<radio/>是互斥的，当一个按钮被选中后，之前选中的按钮就变为非选。它们的属性如表所示。

radio-group及radio组件属性

示例代码如下：

<!--pages/radio/radio.wxml-->
<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>
// pages/radio/radio.js
Page({

  /**
   * 页面的初始数据
   */
  data: {
radios:[
    {name:'java',value:'JAVA'},
    {name:'python',value:'Python',checked:'true'},
    {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.3checkbox

复选框用于从一组选项中选取多个选项，小程序中复选框由<checkbox-group/>(多项选择器)和<checkbox/>(多选项目)两个组件组合而成。一个<checkbox-group/>表示一组选项，可以在一组选项中选中多个选项。它们的属性如表所示。

checkbox-group及checkbox组件属性

示例代码如下：

<!-- 复选框checkbox.xml  -->
<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>
//checkbox.js
Page({
city:"",
  data:{
    citys:[{name:'km',value:'昆明'},
    {name:'sy',value:'三亚'},
    {name:'zh',value:'珠海'},
    {name:'dl',value:'大连'},]
  },
  cityChange:function(e){
    console.log(e.detail.value);
    var city = e.detail.value;
    this.setData({city:city})
  }
})

运行效果图：

4.4.4switch

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

switch组件属性

<!--pages/switch/switch.wxml-->
<view>
<switch bindchange="sw1">{{var1}}</switch>
</view>
<view>
<switch checked bindchange="sw2">{{var2}}</switch>
</view>
<view>
<switch type="checkbox" bindchange="sw3">{{var3}}</switch>
</view>
// pages/switch/switch.js
Page({

  /**
   * 页面的初始数据
   */
  data: {
var1:'关',
var2:'开',
var3:'未选'
  },
  sw1:function(e){
this.setData({var1:e.detail.value?'开':'关'})
  },
  sw2:function(e){
    this.setData({var2:e.detail.value?'开':'关'})
      },
      sw3:function(e){
        this.setData({var3:e.detail.value?'已选':'未选'})
          }
})

运行效果图：

4.4.5slider

slider 组件为滑动选择器，可以通过滑动来设置相应的值，其属性如表所示。

slider组件属性

示例代码如下：

<!--pages/slider/slider.wxml-->
<view>默认min=0 max=100 step=1</view>
<slider></slider>
<view>显示当前值</view>
<slider show-value></slider>
<view>设置min=20 max=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>


// pages/slider/slider.js
Page({

  /**
   * 页面的初始数据
   */
  data: {
size:'20'
  },
  sliderchange:function(e){
      this.setData({size:e.detail.value})
  }
})

运行效果图：

4.4.6picker

picker 组件为滚动选择器，当用户点击picker组件时，系统从底部弹出选择器供用户选择。picker 组件目前支持5种选择器，分别是:selector(普通选择器)、multiSelector(多列选择器)、time(时间选择器)、date(日期选择器)、region(省市选择器)。

1..普通选择器

普通选择器(mode=selector)的属性如表所示。

picker组件中selector选择器属性

示例代码如下：

<!--pages/picker/picker.wxml-->
<view>---range为数组--</view>
<picker range="{{array}}" value="{{index1}}"bindchange='arrayChange'>
当前选择：{
    {array[index1]}
}
</picker>
<view>---range为数组对象--</view>
<picker range="{{array}}" value="{{index2}}"bindchange='arrayChange'>
当前选择：{
    {array[index2]}
}
</picker>

<picker
bindchange="objArrayChange" value="{{index2}}" range-key="name" range="{{objArray}}">
当前选择：{{objArray[index2].name}}
</picker>

// pages/picker/picker.js
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.多列选择器

多列选择器(mode=multiSelector)允许用户从不同列中选择不同的选择项，其选项是二维数组或数组对象。多列选择器的属性如表所示:

picker 组件 multiSelector 选择器属性

示例代码如下：

<!--pages/picker2/picker2.wxml-->
<view>多列选择器</view>
<picker mode="multiSelector" bindchange="bindMultiPicker-Change" bindcolumnchange="bindMultiPickerColumnChange"
value="{{multIndex}}" range="{{multiArray}}">
<view>
当前选择：{{multiArray[0][multIndex[0]]}},{{multiArray[1][multiIndex[1]]}},{{multiArray[2][multiIndex[2]]}}
</view>
</picker>

// pages/picker2/picker2.js
Page({
  data: {
multiArray:[['陕西省','广东省'],['西安市','汉中市','延安市'],['雁塔区','长安区']],
multiIndex:[0,0,0]
  },
  //绑定Multipicker
  bindMultiPickerChange:function(e){
console.log('picker发送选择改变，携带值为',e.detail.value)
this.setData({
    multiIndex:e.detail.value
})
  },
  //绑定MultiPickerColumn
  bindMultiPickerColumnChange:function(e){
      console.log('修改的列为',e.detail.column,'值为',e.detail.value);
      var data={
          multiArray:this.data.multiArray,
          multiIndex:this.data.multiIndex
      };
      data.multiIndex[e.detail.column]=e.detail.value;
      switch(e.detail.column){
          case 0:
            switch(data.multiIndex[0]){
                case 0:
              data.multiArray[1]=['西安市','汉中市','延安市'];
              data.multiArray[2]=['雁塔区','长安区'];
              break;
          case 1:
              data.multiArray[1]=['深圳市','珠海市'];
              data.multiArray[2]=['南山区','罗湖区'];
              break;
      }
      data.multiIndex[1]=0;
      data.multiIndex[2]=0;
    break;
    case 1:
        switch(data.multiIndex[0]){
            case 0:
                switch(data.multiIndex[1]){
                    case 0:
                        data.multiArray[2]=['雁塔区','长安区'];
                        break;
                        case 1:
                            data.multiArray[2]=['汉台区','南郑区'];
                            break;
                            case 2:
                                data.multiArray[2]=['宝塔区','子长县','延川县'];
                                break;
                }
                break;
                case 1:
                    switch(data.multiIndex[1]){
                        case 0:
                                    data.multiArray[2]=['南山区','罗湖区'];
                                    break;
                                    case 1:
                                        data.multiArray[2]=['香洲区','斗门区']; 
                    }
                                        break;  
                        }  
                        data.multiIndex[2]=0;
                        console.log(data.multiIndex); 
                        break;                     
        }
        this.setData(data);
    },
})

运行效果图：

3.时间选择器，日期选择器

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

picker组件time选择器属性

picker组件date选择器属性

示例代码如下：

<!--pages/picker-datetime/picker-datetime.wxml-->
<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>

// pages/picker-datetime/picker-datetime.js
Page({

  data: {
startdate:2000,
enddate:2050,
date:'2018',
starttime:'00:00',
endtime:'12:59',
time:'8:00'
  },
  changedate:function(e){
      this.setData({date:e.detail.value});
      console.log(e.detail.value)
  },
  changetime:function(e){
    this.setData({time:e.detail.value});
    console.log(e.detail.value)
  }
})

运行效果图：

4.省市选择器

省市选择器(mode=region)是小程序的新版本提供的选择快速地区的组件，其属性如表所示。

picker组件region选择器属性

示例代码如下：

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

// pages/picker-region/picker-region.js
Page({
  data: {
 region:['陕西省','西安市','长安区'],
 customtime:'全部'
  },
changeregion:function(e){
    console.log(e.detail.value)
    this.setData({
        region:e.detail.value
    })
}
})

运行效果图：

4.4.7picker-view

picker-view 组件为嵌入页面的滚动选择器。相对于picker组件，picker-view组件的列的个数和列的内容由用户通过<picker-view-column/>自定义设置。picker-view组件的属性如表所示。

picker-view 组件属性

示例代码如下：

<!--pages/picker-view/picker-view.wxml-->
<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>


// pages/picker-view/picker-view.js
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],
  },
  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.8input

input 组件为输入框，用户可以输入相应的信息，其属性如表所示

input组件属性

属性名	类型	说明
value	String	输入框的初始内容
type	String	input 的类型，有效值有text、number、idcard(身份证号)、digit、time、 date，默认值为 text
password	Boolean	是否是密码类型，默认值为false
placeholder	String	输入框为空时占位符
placeholder -- style	String	指定 placeholder 的样式
placeholder - class	String	指定 placeholder 的样式类，默认值为 input -placeholder
disabbled	Boolean	是否禁用，默认值为false
maxlength	Number	最大输入长度。设置为-1则表示不限制最大长度。默认值为140
cursor – spacing	Number	指定光标与键盘的距离，单位为px。取input距底部的距离和cursor- spacing 指定距离的最小值作为光标与键盘的距离
auto - focus	Boolean	自动聚焦，拉起键盘（即将废弃），默认值为false
focus	Boolean	获取焦点，默认值为 false
confirm - type	String	设置键盘右下角按钮的文字，有效值包括send、search、go、next、 done，默认值为 done
confirm - hold	Boolean	点击键盘右下角按钮时是否保持键盘不收起，默认值为false
cursor	Number	指定 focus 时的光标位置
bindchange	EventHandle	当键盘输入时，触发 input事件，event. detail = value，cursor，处理函数可以直接return 一个字符串，将替换输入框的内容
bindinput	EventHandle	输入框聚焦时触发，event.detail= value:value
bindfocus	EventHandle	输入框失去焦点时触发，event.detail=\|value:value
bindblur	EventHandle	点击“完成”按钮时触发，event. detail= value:value

示例代码如下：

<!--pages/input/input.wxml-->
<input placeholder="这是一个可以自动聚焦的input" auto-focus/>
<input placeholder="这个只有在按钮点击的时候才聚焦" focus="{{focus}}"/>
<button bindtap="bindButtonTap">使得输入框获取焦点</button>
<input maxlength="10" placeholder="最大输入长度为10"/>
<view class="section_title">你输入的是:{{inputValue}}
<input bindinput="bindKeyInput" placeholder="输入同步到view中"/>
</view>
<input bindinput="bindReplaceInput"placeholder="连续的两个1会变成2"/>
<input password type="number" placeholder="输入数字密码"/>
<input password type="text" placeholder="输入字符密码"/>
<input type="digit" placeholder="带小数点的数字键盘"/>
<input type="idcard" placeholder="身份证输入键盘"/>
<input placeholder-style="color:red" placeholder="占位符字体是红色的"/>


// pages/input/input.js
Page({
  data: {
focus:false,
inputValue:""
  },
  bindButtonTap:function(){
      this.setData({
          focus:true
      })
  },
  bindKeyTap: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').lenght
   }
    return{
        value:value.replace(/11/g,'2'),
        cursor:pos
    }
    //或者直接返回字符串，光标在最后边
}
})

运行效果图：

4.4.9textarea

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

textarea 组件的属性

属性名	类型	说明
value	String	输入框的初始内容
placeholder	String	输入框为空时占位符
placeholder – style	String	指定 placeholder 的样式
placeholder - class	String	指定 placeholder 的样式类，默认为 input - placeholder
disabled	Boolean	是否禁用，默认为false
maxlength	Number	最大输入长度。设置为-1时，表示不限制最大长度
auto - focus	Boolean	自动聚焦，拉起键盘（即将废弃），默认值为 false
focus	Boolean	获取焦点，默认值为 false
auto - height	Boolean	是否自动增高，设置 auto - height 时 style. height 不生效，默认为 false
fixed	Boolean	如果 textarea 是在一个 position: fixed的区域，需要显示指定属性 fiexed 为 true，默认值为false
cursor - spacing	Number	指定光标与键盘的距离，单位为px。取input距底部的距离和cur- sor- spacing 指定距离的最小值作为光标与键盘的距离，默认值为0
cursor	Number	指定 focus 时的光标位置
show - confirm - bar	Boolean	是否显示键盘上方带有“完成”按钮那一栏，默认值为true
bindfocus	EventHandle	输入框聚焦时触发，event. detail = \| value:value
bindblur	EventHandle	输入框失去焦点时触发，event. detail = \|value:value
bindchange	EventHandle	输入框行数变化时调用，event. detail = \|height:0,heightRpx:0,line- count:0
bindinput	EventHandle	当键盘输入时，触发input 事件，event. detail = \| value, cursor \|. bindinput 处理函数的返回值并不会反映到textarea上
bindconfirm	EventHandle	点击“完成”时，触发confirm 事件，event. detail = \| value:value

示例代码如下：

<!--pages/textarea/textarea.wxml-->
<textarea bindblur="bindTextAreaBlur" auto-height placeholder="自动变高"/>
<textarea  placeholder="placeholder 颜色是红色的" placeholder-style="color:red"/>
<textarea placeholder="这是一个可以自动聚焦的textarea" auto-focus/>
<textarea placeholder="这个只有在按钮点击的时候才聚焦" focus="{{focus}}"/>
<button bindtap="bindButtonTap">使得输入框获取聚焦</button>
<form bindsubmit="bindFormSubmit">
<textarea placeholder="form中的textarea" name="textarea"/>
<button form-type="submit">提交</button>
</form>

// pages/textarea/textarea.js
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.10label

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

示例代码如下：

<!--pages/label/label.wxml-->
<!-- 单击中国不能选择/取消复选框 -->
<view>
<checkbox></checkbox>中国
</view>
<!-- 中国可以选择/取消复选框 -->
<view>
<label>
<checkbox></checkbox>中国</label>
</view>
<!-- 使用for找到对应的id -->
<checkbox-group bindchange="cityChange">
<label wx:for="{{citys}}">
<checkbox value="{{item.value}}" chencked="{{item.checked}}">
{{item.value}}
</checkbox>
</label>
</checkbox-group>
<view>您的选择是：{{city}}</view>

// pages/label/label.js
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.11form

form 组件为表单组件，用来实现将组件内的用户输入信息进行提交。当<form/>表单中 formType为 submit 的<button/>组件时，会将表单组件中的 value 值进行提交。form 组件的属性如表所示。

示例代码如下：

<!--pages/form/form.wxml-->
<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 form-type="submit">提交</button>
<button form-type="reset">重置</button>
</form>


// pages/form/form.js
Page({

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

运行效果图：

4.5多媒体组件

多媒体组件包括 image(图像)、audio(音频)、video(视频)、camera(相机)组件使用这些组件，可以让页面更具有吸引力。

4.5.1image

image 组件为图像组件，与HTML中的<img/>类似，系统默认 image 组件的宽度为300 px、高度为2250px，image 组件的属性如表所示。

image 组件中的mode 属性有13 种模式，其中缩放模式有4种，裁剪模式有9种
1.缩放模式

scaleToFill 不保持纵比缩放图片，使图片的宽高完全拉伸至填满image 元素。
aspectFit 保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以将图片完整地显示出来。
aspectFill 保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说图片通常只在水平或垂直方向是完整的，在另一个方向将会发生截取。
widthFix 宽度不变，高度自动变化，保持原图宽高比不变。

示例代码如下：

<!--pages/image/image.wxml-->
<block wx:for="{{modes}}">
<view>当前图片模式是:{{item}}</view>
<image mode="{{item}}" src="./feel.jpg" style="width: 100% ,height: 100%;"></image>
</block>

// pages/image/image.js
Page({

   data: {
modes:[
    'scaleToFill','aspectFit','aspectFill','widthFix'
]

   }
})

运行效果图：

2.裁剪模式

top 不缩放图片，只显示图片的顶部区域
bottom 不缩放图片，只显示图片的底部区域
center 不缩放图片，只显示图片的中间区域，
lett 不缩放图片，只显示图片的左边区域。
right 不缩放图片，只显示图片的右边区域。
top_left 不缩放图片，只显示图片的左上边区域,
top_right 不缩放图片，只显示图片的右上边区域。
bottom_left 不缩放图片，只显示图片的左下边区域
bottom_right 不缩放图片，只显示图片的右下边区域

示例代码如下：

<!--pages/image/image.wxml-->

<block wx:for="{{modes}}">
<view>当前图片模式是:{{item}}</view>
<image mode="{{item}}" src="./feel.jpg" style="width: 100% ,height: 100%"></image>
</block>


// pages/image/image.js
Page({

   data: {
 modes: ['top','center','bottom','left','right','top_left', 'top_right','bottm_left','bottom_right']
   }
})

运行效果图：

4.5.2 audio

audio组件用来实现音乐播放、暂停等，其属性如表所示

属性名	类型	说明
action	Object	控制音频的播放、暂停、播放速率、播放进度的对象，有 method 和 data 两个参数
sre	Sting	要播放音频的资源地址
loop	Boolean	是否循环播放，默认值为 false
controls	Boolean	是否显示默认控件，默认值为true
poster	String	默认控件上的音频封面的图片资源地址，如果 controls 属性值为false，则设置 poster 无效
name	String	默认控件上的音频名字，如果 controls属性值为false，则设置name无效，默认为“未知音频”
author	String	默认控件上的作者名字，如果 controls 属性值为 false，则设置 name 无效默认为“未知作者”
binderror	EventHandle	当发生错误时触发 error 事件，detail =\|errMsg: MediaError.code
bindplay	EventHandle	当开始/继续播放时，触发 play 事件
bindpause	EventHandle	当暂停播放时，触发 pause 事件
bindratechange	EventHandle	当播放速率改变时触发 ragechange 事件
Bindtimeupdate	EventHandle	当播放进度改变时触发 timeupdate 事件，detail =\|currentTie. duration
bindended	EventHandle	当播放到末尾时触发ended 事件

示例代码如下：

<!--pages/audio/audio.wxml-->
<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>


// pages/audio/audio.js
Page({
  data: {
poster:'https://y.qq.com/music/photo_new/T002R300x300M000003TuCx92hV0eF_1.jpg?max_age=2592000',
name:'my city',
author:'G Herbo/24kGoldn/凯恩.布朗',
src:'https://ws6.stream.qqmusic.qq.com/C400003SCXS33ltFxD.m4a?guid=3152879812&vkey=765D996E1281388C96216F4716B9A1C49472185427FC26088473536385977D6ACE809B83E05A4971B734D380072E7DBE48A097C010F5A5E2&uin=&fromtag=120032'
  },
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)
},
currenTime:function(e){
    this.setData({
        action:{
            method:'setCurrentTime',
            data:120
        }
    })
}
})

运行效果图：

4.5.3 video

video 组件用来实现视频的播放、暂停等。视频的默认宽度为300px，高度为225p,video组件的属性如表所示。

属性名	类型	说明
src	String	要播放视频的资源地址
initial -time	Number	指定视频初始播放位置
duration	Number	指定视频时长
coatrols	BooJean	是否显示默认播放控件（播放/暂停按钮、播放进度、时间)，默认值为 true
danmu - list	ObjectArray	弹幕列表
danmu- htn	Boolean	是否显示弹幕按钮，只在初始化时有效，不能动态变更，默认值为false
enable - danm	Boolean	是否展示弹幕，只在初始化时有效，不能动态变更
autoplay	Boelran	是否自动播放，默认值为 falme
loop	Boelean	是否循环播放，默认值为 false
muted	Boolean	是否静音播放，默认值为 false
page - gestur	Boolean	在非全屏模式下，是否开启亮度与音量调节手势
bindplay	EventHandle	当开始/继续播放时，触发 play 事件
bindpause	EventHandle	当暂停播放时，触发 pause 事件
bindended	EventHandle	当播放到末尾时，触发 ended 事件
bindtimeupdate	EventHandle	当播放进度变化时触发，cvent. detail = \|curree(Time:“当前播放时网'1。触发频率应该在250 ms一次
Bindfullscreenchangr	EventHandle	当视频进入和退出全屏时触发，event. detail = \| fullScreen:“当前全屏状态^
objeetFit	Srring	当视频大小与 video 容器大小不一致时，视频的表现形式。coa- tain：包含；fl：填充；cover：覆盖
poster	String	默认控件上的音频封面的图片资源地址，如果 contnols属性值为 e设置无故

示例代码如下:

<!--pages/video/video.wxml-->
<video src="{{src}}" controls style="width: 100%;"></video>
<view class="btn-area">
<button bindtap="bindButtonTap">获取视频</button>
</view>



// pages/video/video.js
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组件为系统相机组件，可以实现拍照或录像功能。在一个页面中，只能有一个camera 组件。在开发工具中运行时，使用电脑摄像头实现拍照或录像;在手机中运行时，使用手机前后摄像头实现拍照或录像。camera 组件的属性如表所示。

示例代码如下：

<!--pages/camera/camera.wxml-->
<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>

// pages/camera/camera.js
Page({
takePhoto(){
const ctx=wx.createCameraContext()
ctx.takePhoto({
    quality:'high',
    success:(res)=>{
        this.setData({
            src:res.tempImagePath
        })
    }
})
},
error(e){
    console.log(e.detail)
}
})

运行效果图：

4.6其他组件

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

4.6.1map

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

map 组件的属性如表所示

map 组件的markers属性用于在地图上显示标记的位置，其相关属性如表所示。

map 组件的polyline 属性用来指定一系列坐标点，从数组第一项连线到最后一项，形成一条路线，可以指定线的颜色、宽度、线型以及是否带箭头等，其相关属性如表所示。

示例代码如下：

<!--pages/map/map.wxml-->
<map id ="map" 
longitude="108.9200"
latitude="34.1550"
scale="14"
controls="{{controls}}"
bindcontroltap="controltap"
markers="{{markers}}"
bindmarkertap="markertap"
polyline="{{polyline}}"
bindregionchange="regionchange"
show-location
style="width: 100%; height: 300px;"></map>


// pages/map/map.js
Page({
  data: {
markers:[{
    iconPath:'',
    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:'',
        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.2canvas

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

实现绘图需要3步:

(1)创建一个 canvas 绘图上下文。

var context=wx.createCanvasContext('myCanvaas')

(2)使用 canvas 绘图上下文进行绘图描述。

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

(3)画图。

context.draw()

示例代码如下：

<!--pages/canvas/canvas.wxml-->
<canvas canvas-id="myCanvas" style="border: 1px solid  red;"></canvas>

// pages/canvas/canvas.js
Page({
onLoad:function(options){
    var ctx = wx.createCanvasContext('myCanvas')
ctx.setFillStyle('green')//设置绘图上下文的填充色为绿色
ctx.fillRect(10,10,200,100) //方法画一个矩形,填充为设置的绿色
ctx.draw()
}
})

运行效果图：

第五章即速应用

5.1 即速应用概述

1.开发流程简单，零门槛制作

使用即速应用来开发微信小程序的过程非常简单，无须储备相关代码知识，没有开发经验的人也可以轻松上手。
(1)登录即速应用的官方网站(www.jisuapp.cn)，进入制作界面，从众多行业模板中选择一个合适的模板。
(2)在模板的基础上进行简单编辑和个性化制作。
(3)制作完成后，将代码一键打包并下载。U
(4)将代码上传至微信开发者工具
(5)上传成功后，等待审核通过即可。

5.1.2即速应用界面介绍

登录即速应用官网，单击“注册”按钮，在如图5-1所示的页面填写相应信息，即可完成注册。完成注册后，即可登录账号，使用即速应用。

即速应用的主界面主要分为4个区域，分别为菜单栏、工具栏、编辑区和属性面板，如图所示。

1.菜单栏

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

2.工具栏

工具栏包括“页面管理”“组件库”2个的选项卡,“页面管理”实现添加页面和添加分组以及对某一页面进行改名、收藏、复制、删除操作。“组件库”有9个基础组件、7个布局组件、18个高级组件和2个其他组件。

3.编辑区

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

4.属性面板

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

5.2即速应用组件

即速应用提供了大量的组件供用户快速布局页面，包括7个布局组件、9个基本组件18 个高级组件和2个其他组件。

5.2.1 布局组件

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

1.双栏组件

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

2.面板组件

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

3.自由面板组件

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

4.顶部栏导航组件

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

5.底部导航组件

底部导航组件固定于页面底部，用于编辑底部的导航。底部导航组件的属性面板设置如图所示。

通过底部导航组件可以添加标签、删除标签, 同时可以分别设置每个标签的名称、原始图片、点击图片及链接至某一页面; 通过组件面板可以进行组件背景色、图片及文字的设置。底部导航组件的制作效果，如图所示。

5.2.2基本组件

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

1.标题组件

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

2.轮播组件

轮播组件用于实现图片的轮播展示, 其属性面板如图所示。

3.分类组件

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

4.图片列表组件

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

5.图文集组件

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

第六章 API应用

6.1 网络API

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

网络API可以帮助开发者实现网络URL访问调用、文件的上传和下载、网络套接字的使用等功能处理。微信开发团队提供了10个网络API接口。

wx.request(Object) 接口用于发起HTTPS请求。
wx.uploadFile(Object) 接口用于将本地资源上传到后台服务器。
wx.downloadFile(0bject)接口用于下载文件资源到本地。
wx.connectSocket(0bject)接口用于创建一个 WebSocket 连接。
wx.sendSocketMessage(0bject)接口用于实现通过 WebSocket 连接发送数据。
wx.closeSocket(0bject)接口用于关闭 WebSocket 连接。
wx.onSocketOpen(CallBack)接口用于监听WebSocket 连接打开事件。
wx.onSocketError(CallBack)接口用于监听 WebSocket 错误。
wx.onSocketMessage(CalBack)接口用于实现监听WebSocket 接收到服务器的消息事件。
wx.onSocketClose(CalBack)接口用于实现监听 WebSocket 关闭。

在本节，我们将介绍常用的3个网络API。

6.1.1 发起网络请求

wx.request(0bject)实现向服务器发送请求、获取数据等各种网络交互操作，其相关参数如表所示。一个微信小程序同时只能有5个网络请求连接，并且是 HTTPS 请求。

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

代码示例如下：

<!--pages/baidu/baidu.wxml-->
<button type="primary"bindtap="getbaidutap">获取HTML数据</button>
<textarea value="{{html}}"auto-heightmaxlength='0'></textarea>

pages/baidu/baidu.js

// pages/baidu/baidu.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.repuest(Obiect)的GEF方法获取邮政编码对应的地址信息。

示例代码如下：

<!--pages/postcode/postcode.wxml-->
<view>邮政编码：</view>
<input type="text" bindinput="input" placeholder="6位邮政编码"/>
<button type="primary"bindgtap="find">查询</button>
<block wx:for="{{address}}">
<block wx:for="{{item}}">
<text>{{item}}</text>
</block>
</block>


// pages/postcode/postcode.js
Page({
  data: {
      postcode:"",
      addtress:[],
      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;
          wx.showToast({
            title: '正在查询，请稍后....',
            icon:'loading',
            duration:'10000'
          });
          wx.request({
            url: 'http//v.juhe.cn/postcode/query',
            data:{
                'postcode':postcode,
                'key':'0ff9bfccdf14746e067de994eb5496e'
            },
            header:{
                'Content-Type':'application/json',
            },
            method:'GEF',
            success:function(res){
                wx.hideToast();
                if(res,data.error_code ==0){
                    console.log(res);
                    self.setData({
                        errMsg:"",
                        error_code:res.data.error_code,
                        addtress:res.data.result.list
                    })
                }
                else{
                    self.setData({
                        errMsg:res.data.reason||res.data.reason,
                        error_code:res.data.error_code
                    })
                }
            }
          })
      }
  }
})

运行效果图：

6.1.2 上传文件

wx.uploadFile(Object)接口用于将本地资源上传到开发者服务器，并在客户端发起一个HTTPS POST 请求，其相关参数如表所示。

通过 wx.uploadFile(0bject)，可以将图片上传到服务器并显示。示例代码如下:

<!--pages/upload/upload.wxml-->
<button type="primary" bindtap="uploadimage">上传图片</button>
<image src="{{img}}" mode="widthFix"/>
 
// pages/upload/upload.js
Page({
  data: {
img:null,
  },
  uploadimage:function(){
    var that=this;
    //选择图片
    wx.chooseImage({
        success:function(res){
            var temFilePaths = res.tempFilePaths
            upload(that,temFilePaths);
        }
    })
  function upload(page,path){
    wx.showToast({
        icon:"loading",
      title: '正在上传',
    }),
wx.uploadFile({
    url:"http://localhost",
  filePath: 'path[0]',
  name: 'file',
success:function(res){
console.log(res);
if(res.statusCode != 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(){
    wx.hideToast();
}
})
  }
  }
})

运行效果图：

6.1.3 下载文件

wx. downloadFile(Object)接口用于实现从开发者服务器下载文件资源到本地，在客户端直接发起一个 HTTP GET请求，返回文件的本地临时路径。其相关参数如表所示。

例如，通过 wx.downloadFile(0bject)实现从服务器中下载图片，后台服务采用 WAMP软件在本机搭建。

示例代码如下：

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

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

运行效果图：

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保存图片到本地。其相关参数如表所示。

若调用成功，则返回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)
}
})

2.预览图片

wx. previewImage（Object）接口主要用于预览图片，其相关参数如表所示。

示例代码如下：

wx.previewImage({
//定义显示第二张
current:"http://bmob-cdn-16488.b0.upaiyun.com/2018/02/05/2.png",
urlls:["http://bmob-cdn-16488.b0.upaiyun.com/2018/02/05/2.png",
"http://bmob-cdn-16488.b0.upaiyun.com/2018/02/05/2.png",
"http://bmob-cdn-16488.b0.upaiyun.com/2018/02/05/2.png",

]
})

3.获取图片信息

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)
}
})
},
})

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（）接口。其相关参数如表所示。

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）接口用于开始播放语音，同时只允许一个语音文件播放，如果前一个语音文件还未播放完，则中断前一个语音文件的播放。其相关参数如表所示。

示例代码如下：

wx.startRecord({
success: function(res){
var tempFilePath= res.tempFilePath wx.playVoice({//录音完后立即播放
filePath:tempFilePath, complete:function(){
}
})
}
})

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）用于播放音乐，同一时间只能有一首音乐处于播放状态，其相关参数如表所示。

示例代码如下：

wx.playBackgroundAudio({
dataUrl:'http://bmob-cdn-16488.b0.upaiyun.com/2018/02/09/117e4a1b405195b18061299e2de89597.mp3',
title:'有一天',
coverImgUrl:'http://bmob-cdn-16488.b0.upaiyun.com/2018/02/09/f604297140c968188cc3d3e581f7724.jpg',
success:function(res){
console.log(res)
}
})

2.获取音乐播放状态

wx.getBackgroundAudioPlayerState（Object）接口用于获取音乐播放状态，其相关参数如表所示。

接口调用成功后返回的参数如表所示。

示例代码如下：

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（Object）接口用于控制音乐播放进度，其相关参数如表所示。

示例代码如下：

wx.seekBackgroundAudio({
posiyion:30
})

4.暂停播放音乐

wx. pauseBackgroundAudio（）接口用于暂停播放音乐。

示例代码如下：

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);//5秒自动停止

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. wxml的代码如下：

<!--pages/music/music.wxml-->
<view class="container">
<image class="bgaudio"src = "{{changedImg? music.coverImg:'./images/ctiy.png'}}"/>
<view class ="control-view">
<!--使用data-how定义一个0表示快退10秒-->
<image src ="./images/back.png"bindtap="onPositionTap"data-how= "0 "/>
<image src = "./images/{{isPlaying?'pause':'play'}}.png " bindtap = "onAudioTap"/>
<image src ="./images/stop.png"bindtap = "onStopTap"/>
<!--使用data-how定义一个1表示快进10秒-->
<image src ="./images/go.png"bindtap ="onPositionTap"data-how = "1"/>
</view >
</view >

music. wxss的代码如下：

/* pages/music/music.wxss */
.bgaudio{
    height:350rpx; 
    width:350rpx;
    margin-bottom:100rpx;
  }
    .control-view image{ 
    height:64rpx;
       width:64rpx; 
       margin:30rpx;
  }

music. js的代码如下：

// pages/music/music.js
Page({
    data:{
     //记录播放状态
    isPlaying:false,
    //记录coverImg,仅当音乐初始时和播放停止时,使用默认的图片。播放中和暂停时，都使用当前音乐的图片
    coverImgchangedImg:false,	
    //音乐内容 
    music:{
    "url":"https://ws6.stream.qqmusic.qq.com/C400003SCXS33ltFxD.m4a?guid=1833608456&vkey=C2FDF4FAB66F42D8F7286D746D31997FF3B4AA2E03633F4C971257D6711F83CA284EFA51B2C0717F5FA0313B8DE11EBACB0F397394E717D2&uin=&fromtag=120032",
    "title":"G Herbo /24kGoldn /Kane Brown-My City",
    "coverImg":
    "https://y.qq.com/music/photo_new/T002R300x300M000003TuCx92hV0eF_1.jpg?max_age=2592000"
        },
    },	
    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");	
  });	
  }
  })

运行效果图：

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）用于保存文件到本地，其相关参数如表所示。

示例代码如下：

saveImg:function(){
    wx.chooseImage({
        count:1,
        sizeType:['original','compressed'],
        sourceType:["album",'camera'],
        success:function(res){
        var tempFilesPaths=res.tempFilePaths[0]
        wx.saveFile({
        tempFilePath: 'tempFilePaths',
        success:function(res){
            var tempFilesPaths=res.tempFilePath;
        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）接口。其相关参数如表所示。

示例代码如下：

 wx.chooseImage({
            count:1,
            sizeType:['original','compressed'],
            sourceType:["album",'camera'],
            success:function(res){
            var tempFilesPaths=res.tempFilePaths[0]
            wx.saveFile({
            tempFilePath: 'tempFilePaths',
            success:function(res){
                var tempFilesPaths=res.tempFilePath;
           wx.getSavedFileInfo({
               filesPath:saveFilePath,
               success:function(res){
                   console.log(res.size)
               }
           })
        }
        })
    }
    })

4.删除本地文件

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

示例代码如下：

wx.getSavedFileList({
        success:function(res){
            if (res.filesPath.length>0){
                wx.removeSavedFile({
                    filesPath:res.filesPath[0].filesPath,
                    complete:function(res){
                        console.log(res)
                    }
                })
            }
        }
    })

5.打开文档

wx.openDocument（Object）接口用于新开页面打开文档，支持格式：doc、xls、ppt、pdf、docx、xlsx、ppts , 其相关参数如表所示。

示例代码如下：

 wx.downloadFile({
      url: 'http://localhoet/fm2.pdf',
      success:function(res){
          var temFilePath=res.tempFilePath;
          wx.openDocument({
            filePath: 'tempFilePath',
            success:function(res){
                console.log("打开成功")
            }
          })
      }
    })

6.4 本地数据及缓存API

小程序提供了以键值对的形式进行本地数据缓存功能，并且是永久存储的，但最大不超过10 MB，其目的是提高加载速度。数据缓存的接口主要有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（Object）接口将数据存储到本地缓存接口指定的key中，接口执行后会覆盖原来key对应的内容。其参数如表所示。

示例代码如下：

wx.setStorage({
key:'name',
data:'sdy',
success:function(res){
console.log(res)
}
})

运行效果图：

2.wx.setStorageSync(key,data)

wx. setStorageSync（key, data）是同步接口，其参数只有key和data。

示例代码如下:

wx.setStorageSync('age','25')

6.4.2 获取数据

1.wx.getStorage(Object)

wx. getStorage（Object）接口是从本地缓存中异步获取指定key对应的内容。其相关参数如表所示。

示例代码如下：

wx.setStorage({
key:'name',
success:function(res){
console.log(res.data)
},
})

2.wx. getStorageSync（key）

wx. getStorageSync（key）从本地缓存中同步获取指定key对应的内容。其参数只有key。

try{
var value =wx.getStorageSync('age')
if(value){
console.log("获取成功")
}
}catch(e){
console.log("获取失败")
}

6.4.3 删除数据

1.wx.removeStorage(Object)

wx. removeStorage（Object）接口用于从本地缓存中异步移除指定key。其相关参数如表所示。

代码示例如下：

wx.removeStorage({
key:'name',
success:function(res){
consloe.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
}

6.4.4 清空数据

1.wx.clearStorage()

wx. clearStorage（）接口用于异步清理本地数据缓存，没有参数。

代码示例如下：

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

2.wx.clearStroageSync()

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

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）调试成功后，返回的参数如表所示。

示例代码如下：

在app.json加入这段代码授权

"permission": {
    "scope.userLocation": {
      "desc": "为了给您提供更好的服务，请授权您的地理位置信息"
    }
  },
  "requiredPrivateInfos": [
      "chooseLocation",
      "getLocation"
  ],

test.wxml

<button class="btn" type="primary" bindtap="handleGetLocation">
  getLocation
</button>

test.js

// pages/test/test.js
Page({
  data: {   
  },
handleGetLocation: function () {
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.chooseLocation({
success:function(res){
console.log("位置的名称:"+res.name);
console.log("位置的地址:"+res.address);
console.log("位置的经度:"+res.longitude); 
console.log("位置的纬度:"+res.latitude); 

}
})

运行效果图：

6.5.3 显示位置信息

示例代码如下：

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（）接口分别用于异步和同步获取系统信息。其相关参数如表所示。

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）用于获取网络类型，其相关参数如表所示。

如果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）接口用于实现调用手机拨打电话，其相关参数如表所示。

示例代码如下：

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

运行效果图：

6.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)
   }
  })

运行效果图：

2201_75484561

关注

4
点赞
踩
9

收藏

觉得还不错? 一键收藏
1
评论
微信小程序(1~6)章总结

组件是页面视图层(WXML)的基本组成单元，组件组合可以构建功能强大的页面结构。小程序框架为开发者提供了容器视图、基础内容、表单、导航、多媒体、地图、画布、开放能力等8类(30多个)基础组件。每一个组件都由一对标签组成，有开始标签和结束标签，内容放置在开始标签和结束标签之间，内容也可以是组件。<标签名属性名=”属性值”>内容…</标签名>组件通过属性来进一步细化。不同的组件可以有不同的属性，但它们也有一些共用属性，如id、class、style、hidden、data-*、bind */catch*等。
复制链接

扫一扫