第一章 认识微信小程序
简介:1.1认识微信小程序
微信(WeChat)是腾讯公司于2011年1月21日推出的一款为智能终端提供即时通信( Instant Messaging,IM)服务的应用程序
微信之父张小龙曾经解释:小程序是一种不需要下载安装即可使用的应用,它实现了应用“触手可及”的梦想,用户扫一扫(二维码)或者搜一下(关键词)即可打 应用。信小程序 现了“用完即走”的理念,用户不用关心是否安装太多应用的问题。有了微小程序,应用将无处不在,随时可用,且无须安装与卸载。
特征:
1. 无须安装
小程序内嵌于微信程序之中,用户在使用过程中无须在应用商店下载安装外部应用。
2.触手可及
用户通过扫描二维码等形式直接进入小程序,实现线下场景与线上应用的即时联通。
3.用完即走
用户在线下场景中,当有相关需求时,可以直接接入小程序,使用服务功能后便可以对其不理会,实现用完即走。
4.无须卸载
用户在访问小程序后可以直接关闭小程序,无须卸载。
场景:
1.简单的业务逻辑
简单是指应用本身的业务逻辑并不复杂。
2.低频度的使用场景
低频度是小程序使用场景的另一个特点。
开发者工具界面功能介绍
1.工具栏
在工具栏中可以实现多种功能,例如账号的切换,模拟区、编辑区、调试区的显示/隐
藏,小程序的编译、预览,切换后台,清理缓存等。
2. 模拟区
在模拟区中选择模拟手机的类型、显示比例、网络类型后,模拟器中会显示小程序的运行效果。
3.目录文件区
目录文件区用来显示当前项目的目录结构,单击左上角的“+”按钮可以进行目录和文件的创建,右键单击目录文件区中的文件或目录可以进行“硬盘打开”“重命名”“删除”等相关操作。
4. 编辑区
编辑区用来实现对代码的编辑操作,编辑区中支持对.wxml、.wxss、.js及.json文件的操作,使用组合键能提高代码的编辑效率。常用的组合键如表
5. 调试区
调试区的功能是帮助开发者进行代码调试及排查有问题的区域。小程序系统为开发者提供了9个调试功能模块,分别是Console、Sources、Network,Security, Sorage、AnpData, W、ne。最的菜单项 定制与控制开发工具钮 。
1) Console 面板
Console面板是调试小程序的控制面板,当代码执行出现错误时,错误信息将显示在 Console 面板中,便于开发者排查错误,如图1-25所示。另外,在小程序中,开发者可以通过console.log语句将信息输出到Console面板中。此外,开发者可以在Console面板直接输
入代码并调试。
2) Sources 面板
Sources 面板是源文件调试信息页,用于显示当前项目的脚本文件,如图1-26所示。调试区左侧显示的是源文件的目录结构,中间显示的是选中文件的源代码,右侧显示的是调试相关按钮
Sources 面板中显示的代码是经过小程序框架编译过的脚本文件,开发者的代码会被包含在 define 函数中。对于Page代码,在文件尾部通过require函数主动调用。
3) Network 面板
Network 面板是网络调试信息页,用于观察和显示网络请求request和socket等网络相关的详细信息 。
4) Security面板
Security 面板是安全认证信息页,开发者可以通过该面板调试当前网页的安全和认证等问
中文件的源代码,右侧显示的是
题。如果设置安全论证,则会显示“The security of this page is unknown.” 。
Breakpoints 5) Storage面板
Storage面板是数据存储信息页,开发者可以使用wx.setStorage或者wx.setStorageSyne将数据
存储到本地存储,存储在本地存储中的变量及值可以在Storage面板中显示 。
5) Storage 面板
Storage 面板是数据存储信息页,开发者可以使用wx.setStorage 或者wx.setStorageSync将数据存储到本地存储,存储在本地存储中的变量及值可以在Storage面板中显示 。
6) AppData 面板
AppData面板是实时数据信息页,用于显示项目中被激活的所有页面的数据情况者在这里不仅可以查看数据的使用情况,还可以更改数据。编辑器会实时地将数据的
况反映到前端界面
7) Wxml 面板
Wxml 面板是布局信息页,主要用于调试Wxml组件和相关CSS 样式,显示Wxml 转化系的界面。Wxml面板调试区的左侧部分是Wxml代码,右侧部分是该选择器的CSS样式 。
8) Sensor 面板
Sensor 面板是重力传感器信息页,开发者可以在这里选择模拟地理位置来模拟移动设备表现,用于调试重力感应API 。
9) Trace面板
Trace面板是路由追踪信息页,开发者在这里可以追踪连接到电脑中的安章(Meiad)设备的路由信息 。
10)扩展菜单项
最右边的扩展菜单项“”主要包括开发工具的一些定制与设置,开发者可以在这里设置相关信息 。
2.1第二章 小程序基本目录结构
2.1.1主体文件:
微信小程序的主体部分由三个文件组成
app.js:小程序逻辑文件,主要用来注册小程序全局实例。
app.json:小程序公共设置文件,配置小程序全局设置。
app.wxss:小程序主样式表文件,类似HTML的,CSS文件。
project.config.json:文件是式项目配置文件。
pages:目录中保存着一个页面的相关文件。
2.1.2页面文件:
index:.js文件:页面逻辑文件,在该文件中编写javaScript代码控制页面的逻辑。
.wxml文件:页面结构文件,用于设计页面的布局,数据绑定。
.wxss文件:页面样式文件,拥有定义本页面用到的各种各样式表。
.json文件:页面配置文件。该文件在页面中不可缺少。
2.2小程序开发框架
2.2.1视图层:MINA框架的视图层是由WXML与WXSS编写,有组件来进行展示。
.WXML文件用于描述页面的结构;WXSS文件用于描述页面样式。
2.2.2逻辑层:用于处理事务逻辑。逻辑层将数据进行出来后发送给视图层,同时接受视图层的事件反馈。
2.2.3数据层:
数据层在逻辑上包括页面临时数据或缓存,文件储存(本地储存)和网络储存与调用。
1、页面临时数据或缓存
在Page() 中,使用setData函数将数据从逻辑层发送到视图层,同时改变对应的this.data的值。
setData()函数的参数接收一个对象,以(key,value)的形式表示将key 在thi. data中对应的值改变成value。
2.文件存储 (本地存储)
使用数据API 接口,如下:
wx.getStorage获取本地数据缓存。 aster
wx.setStorage设置本地数据缓存。
中, wx.clearStorage清理本地数据缓存。
3.网络存储与调用
的 上传或下载文件API接口,如下:
wx. request发起网络请求。 wx.uploadFile上传文件。 wx.downloadFile下载文件。调用 URL的API接口,如下:
wx.navigateTo新窗口打开页面。 wx.redirectTo原窗口打开页面。
2.3创建小程序页面
2.3.1创建第一个页面文件
继续在项目主目录下新建一个pages目录,在pages目录下新建一个index(随便取一个英文名)目录,并在index目录下新建index.js, index.json,index.wxml, index.wxss空文件。(如图下:)
首先打开kk.wxml文件,输入“欢迎学习小程序”因此打开项目配置文件app.json
打开kk.json文件输入如下代码:
{
}
打开kk.js文件输入 如下代码:
page({
})
2.4配置文件
小程序的配置文件按其作用范围可分为全局配置文件(app.json)和页面配置文件(*.json)。
2.4.4全局配置文件
小程序的全局配置保存在全局配置文件(app.json)中使全局配置文件来配置页面文件(pages)的路径。设置窗口(window)表现,设定网络请求API的超时时间值(networkTimeout)以及配置多个切换页(tabBar)等。
全局配置项
配置项及其描述
1.pages配置项
pages配置项接受一个数组,用来指定小程序由哪些页面组成,数组的每一项都是字符串,代表对应页面的“路径”+“文件名”。pages配置项是必填项。
(1)数组的第一项用于设定小程序的初始页面。
(2)在小程序中新增或减少页面时,都需要对数组进行修改。
(3)文件名不需要写文件扩展名。小程序框架会自动寻找路径及对.js,.json,.wxml和.wxss文件进行整合数据绑定。
{
"pages":[
"pages/news/news",
"pages/index/index"
]
}
2.window配置项
window配置项负责设置小程序状态栏,导航条,标题,窗口背景色等系统样式。
window配置项及其描述
3.tabBar配置项
当需要在小程序顶部或底部设置菜单栏时,可以通过配置tabBar品质项来实现。
tabBar配置项及其描述
其中,list(列表)接受数组值,数组中的每一项也都是一个对象。
tabBar中list选项
4.networkTimeout配置项
小程序中各种网络请求API的超时时间值只能通过networkTimeout配置项进行统一设置,不能在API中单独设置。
netwoekTimeout配置项
5.debug配置项
debug配置项用于开启开发者工具的调试模式,默认为false。开启后,页面的注册,路由,数据更新,事件触发等调试信息将以info的形式输出到Console(控制台)面板上。
2.4.2页面配置文件
页面配置文件(*.json)只能本页面窗口表现,而且只能设置window配置项的内容。
{"navigationBarBackgroundColor":"#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText":"页面window 配置演示","backgroundColor": "#eeeeee",
"backgroundTextStyle": "light" }
2.5逻辑文件
小程序的逻辑层文件分为项目逻辑文件和页面逻辑文件。
2.5.1项目逻辑文件
当启动小程序时,首先会触发生命周期函数onLanch和onShow方法让,然后通过app.json的属性注册相应的页面,最后跟据默认路径加载首页。
项目逻辑文件配置项
2.5.2页面逻辑文件
页面逻辑文件配置项
1.设置初始数据
2.定义当前页面的生命周期函数
2.6页面结构文件
页面结构文件(wxml)是框架设计的一套类似HTML的标签语言,结合基础组件,事件系统,可以建构出页面的结构,即.wxml文件。
2.6.1数据绑定
1.简单绑定
简单绑定是指使用大括号({{}}),可以作用于内容,组件属性,控制属性等的输出。
2.运算
主要有算术运算,逻辑运算,三元运算,字符串运算
2.6.2条件数据绑定
1.wx:if条件数据绑定
wx:if条件数据绑定是指使用wx:if这个属性来判断是否数据绑定当前组件。
2.block wx:if 条件数据绑定
当需要通过一个表达式去控制多个组件时,可以通过<block>将多个组件包起来,然后在<block>中添加wx:if属性。
2.6.3列表数据绑定
列表数据绑定用于将列表中的各项数据进行重复数据绑定。
2.6.4模板
1.定义模板
2.调用模板
2.6.5引用页面文件
1.import方式
如果要引用的文件中定义了模板代码,则需要用import方式引用
2.include方式
include方式可以将原文件中除模板之外的其他代码全部引入,相当于将源文件中的代码全部复制到include所在位置。
2.6.6页面事件
1.定义事件函数在.js文件中定义函数来实现相关功能事件响应后执行事件处理代码。
2.调用事件调用事件也称为注册事件。
3.冒泡事件
4.非冒泡事件
2.7页面样式文件
1.尺寸单位
由于css原有尺寸单位在不同尺寸的屏幕中得不到很好的呈现,在系统绑定中rpx会按比例转换成px。
2.样式导入
为了便于管理wxss文件,我们可以将样式存放在不同的文件中.
3.选择器
4.wxss常用属性
第三章页面布局总结
3.1盒子模型
微信小程序的视图层由WXML和WXSS 组成。其中,WXSS(WeiXin Style Sheets)是基
于CSS拓展的样式语言,用于描述WXML的组成 一边框(bordex) 样式,决定WXML的组件如何显示。WXSS具有 外边距(margin ) CSS 的大部分特性,因此,本章将重点讲解CSS 中 内边距。
(padling) 的布局相关内容此外,对padd,border和maegin进一步细化为上,下,左,右4个部分在css中进行设置
1.width和height内容的宽度和高度
2.padding - top、padding- right、padding - bottom 和padding -left上内边距、右内边距、底内边距和左内边距。
3.border - top、border -right、border - bottom 和 border -left上边框、右边框、底边框和左边框。
4.margin-top、margin-right、margin - bottom 和 margin-left上外边距、右外边距、底外边距和左外边距。
因此,一个盒子实际所占有的宽度(高度)应该由“内容”+“内边距”赔“边框”+“外边距”组成。例如:
3.2块级元素与行内元素
元素按显示方式分为块级元素、行内元素和行内块元素,它们的显示方式由display属性控制。
3.2.1 块级元素
块级元素默认占一行高度,一行内通常只有一个块级元素(浮动后除外),添加新的块级元素时,会自动换行,块级元素一般作为盒子出现。块级元素的特点如下:
(1)一个块级元素占一行。
(2)块级元素的默认高度由内容决定,除非自定义高度。
(3)块级元素的默认宽度是父级元素的内容区宽度,除非自定义宽度。(4)块级元素的宽度、高度、外边距及内边距都可以自定义设置。(5)块级元素可以容纳块级元素和行内元素。
<view/>组件默认为块级元素,使用<view/>组件演示盒子模型及块级元素
3.2.2行内元素
行内元素,不必从新一行开始,通常会与前后的其他行内元素显示在同一行中,它们不占有独立的区域,仅靠自身内容支撑结构,一般不可以设置大小,常用于控制页面中文本的 。将一个元素的display属性设置为inline后,该元素即被设置为行内元素。行内元素的特点如下:
(1)行内元素不能被设置高度和宽度,其高度和宽度由内容决定。
(2)行内元素内不能放置块级元素,只级容纳文本或其他行内元素。
(3)同一块内,行内元素和其他行内元素显示在同一行。
<text/>组件默认为行内元素,使用<view/>及<text/>组件演示盒子模型及行内元素的示例代码如下:
3.2.3 行内块元素
当元素的 display属性被设置为inline-block时,元素被设置为行内块元素。行内块元可以被设置高度、宽度、内边距和外边距。
3.3 浮动与定位
3.3.1元素浮动与清除
元素浮动就是指设置了浮动属性的元素会脱离标准文档流的控制,移到其父元素中指定位置的过程。在CSS 中,通过float属性来定义浮动,其基本格式如下:
{float:none lleft lright;}
其中,none--默认值,表示元素不浮动;
left--元素向左浮动; right--元素向右浮动。
代码中,分别对box1、box2、box3元素左浮动:
3.3.2元素定位
static 默认值
relaute 相对定位
absolute 绝对定位
fixed固定定位
3.4 flex 布局
flex布局是万维网联盟(World Wide Web Consortium,W3C)在2009年提出的一种新布局方案,该布局可以简单快速地完成各种可以伸缩的设计,以便很好地支持响应式布局。 flex 是 flexible box 的缩写,意为弹性盒子模型,可以简便、完整、响应式地实现各种页面布局。
flex 布局主要由容器和项目组成,采用flex布局的元素称为flex容器(flex container), flex 布局的所有直接子元素自动成为容器的成员,称为flex 项目(flex item)。
容器默认存在两根轴:水平的主轴(main axis)和垂直的交叉轴(cross axis)。主轴的开始位置(与边框的交叉点)叫做main start,结束位置叫做main end;交叉轴的开始位置叫做cross start,结束位置叫做cross end。
项目默认沿主轴排列。单个项目占据的主轴空间叫做main size,占据的交叉轴空间叫做 cross size。flex 布局模型如图3-12所示。
设置 display属性可以将一个元素指定为flex 布局,设置flex- direction属性可以指定主轴方向。主轴既可以是水平方向,也可以是垂直方向。
3.4.1容器属性
flex容器支持的属性有七种
1. display
display 用来指定元素是否为flex布局,语法格式为:.box{display:flex linline -flex;}
其中,flex一块级flex布局,该元素变为弹性盒子;
inline -flex-行内flex布局,行内容器符合行内元素的特征,同时在容器内又符合 flex 布局规范。
设置了flex 布局之后,子元素的float、clear和vertical -align 属性将失效。
2. flex - direction
flex - direction用于设置主轴的方向,即项目排列的方向,语法格式为:
.box{flex -direction:rowlrow -reverse lcolumn lcolumn - reverse;}
其中,row-主轴为水平方向,起点在左端,当元素设置为flex布局时,主轴默认为row;
row -reverse--主轴为水平方向,起点在右端; column-主轴为垂直方向,起点在顶端;
column - reverse--主轴为垂直方向,起点在底端。图3-13所示为元素在不同主轴方向下的显示效果。
3. flex - wrap
flex -wrap用来指定当项目在一根轴线的排列位置不够时,项目是否换行,其语法格式如下:.box|flex -wrap:nowrap lwrap lwrap -reverse;}其中,nowrap--不换行,默认值;
wrap--换行,第一行在上方;
wrap - reverse-换行,第一行在下方。
当设置换行时,还需要设置align-item属性来配合自动换行,但align-item的值不能为“ stretch”。
flex- wrap不同值的显示效果
4.flex - flow
flex -flow是flex-direction和flex-wrap的简写形式,默认值为row nowrap。语法格式如下:.box{ flex -flow:<flex -direction > ll<f1ex-wrap>;}示例代码如下:
.box{flex - flow:row nowrap;|//水平方向不换行
.box{flex -flow:row -reverse wrap;} //水平方向逆方向换行.box| flex - flow:column wrap -reverse;} //垂直方向逆方向换行
5. justify - content
justify -content用于定义项目在主轴上的对齐方式。语法格式如下:
.box{justify-content:flex-start lflex - end |center lspace -between Ispace -around;}
其中,justify-content-与主轴方向有关,默认主轴水平对齐,方向从左到右;
flex - start-左对齐,默认值; flex - end-右对齐; center--居中;
space - between一两端对齐,项目之间的间隔都相等; space -around-每个项目两侧的间隔相等。
图3-15所示为justify-content不同值的显示效果。
6.align-items 用于指定项目交叉轴上的对齐方式
flex-start——交叉轴起点对齐
flex-end——交叉轴终点对齐
center——交叉轴中线对齐
baseline——第一行文字基线对齐
stretch——设置高度或设置为auto,拉伸填充容器
7.alingn-content
space-between-与交叉抽端对齐,轴线之间间隔平均分布
space-around-线轴两侧间隔相等,间隔比轴线与边框间隔大一倍
3.4.2项目属性
1.order属性定义项目排列顺序,数值越小,排列越靠前,默认值为0
2.flex-grow定义项目的放大比例
3.flex-shrink用来定义缩小比例,默认值为1
4.flex-basis 属性用来定义伸缩基本项目的基本值,剩余空间按比例进行缩放,它的默认值为auto(即项目的本来大小)
5.flex属性是 flex-grow.flex-shrink和flex-basis的简写默认值分别为0,1,auto
6.align-self 属性指定单独伸缩项目交叉轴上的对齐方式。
第四章页面组件
4.1组件的定义及属性
小程序框架为开发者提供了容器试图,基础内容,表单,导航,多媒体,地图,画布,开放能力等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.1 view
view组件是块级组件,没有特殊功能,主要用于布局展示,相当于HTML 中的div,是布局中最基本的用户界面(UserInterface,UI)组件,通过设置view的CSS属性可以实现各种复杂的布局。view组件的特有属性。
4.2.2 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组件可以实现下拉刷新和上拉加载更多
4.2.3 swiper
swiper组件可以实现轮播图,图片预览,滑动页面等效果。
swiper组件属性
<swiper-item/>组件为滑块项组件,仅可以被放置在<swiper/>组件中,宽度尺寸默认按100%显示。
4.3基础内容组件
基础内容组件包括icon、text和progress,主要用于在视图页面中展示图标、文本和进度条等信息。
4.3.1 icon
icon组件即图标组件,通常用于表示一种状态,如success、info、warn、waiting、cancel等。其内容如下
2.text
text组件用于展示内容,类似HTML中的<span >,text 组件中的内容支持长按选中,支持转义字符“\”,属于行内元素。text组件如下
4.3.3progress
progress组件用于显示进度状态,如资源加载、用户资料完成度、媒体资源播放进度等progress组件属于块级元素,其属性如表
4.表单组件
表单组件的主要功能是收集用户信息,并将这些信息传递给后台服务器,实现小程序与用户之间的沟通。表单组件不仅可以放置在<form/>标签中使用,还可以作为单独组件和其他组件混合使用。
1.button
一般来说button 组件用来实现用户和应用之间的交互,同时按钮的颜色起引导作用。在一个程序一个按钮至少有3种状态:默认点击(default)、建议点击(primary)、谨慎点击(warm)。在构建项目时,应在合适的场景使用合适的按钮,当<button>被<form/>包裹时,可以通过设置form-type 属性来触发表单对应的事件。
4.4.2 radio
单选框用来从一组选项中选取一个选项,在小程序中,单选框由<radio-group/>(单项选择器)和<radio/>(单选项目)两个组件组合而成,一个包含多个<radio/>的<radio-group/>表示一组单选项,在同一组单选项中<radio/>是互斥的,当一个按钮被选中后,之前选中的按钮就变为非选。它们的属性如表下
4.4.3checkbix
复选框用于从一组选项中选取多个选项,小程序中复选框由<checkbox-group/>(多项选择器)和<checkbox/>(多选项目)两个组件组合而成。一个<checkbox-group/>表示一组选项可以在一组选项中选中多个选项。列表如下
4.4.4 switch
switch组件的作用类似开关选择器,其属性如下表
4.4.5.slider
slider组件为滑动选择器可以通过滑动来设置相应的值,其属性如表
4.4.6.picker
picker组件为滚动选择器,当用户点击picker组件时,系统从底部弹出选择器供用户选择。picker组件目前支持5种选择器,分别是:selector(普通选择器)、multiSelector(多列选择器)、time(时间选择器)、date(日期选择器)、region(省市选择器)。
(1)普通选择器
2.多类选择器
多列选择器(mode=multiSelector)允许用户从不同列中选择不同的选择项,其选项是二维数组或数组对象。多列选择器的属性如表
3.时间选择器,日期选择器
时间选择器(mode=tme)可以用于从提供的时间选项中选择相应的时间,其属性如表
日期选择器(mode=date)可以用于从提供的日期选项中选择相应的日期,其属性如表
4.省市选择器
省市选择器(mode=region)是小程序的新版本提供的选择快速地区的组件,其属性如表
4.4.7 picker-view
picker-view组件为嵌人页面的滚动选择器。相对于picker组件,picker-view组件的列的个数和列的内容由用户通过<picker-view-column/>自定义设置。picker-view组件的属性如表
8.input
imput 组件为输人框,用户可以输人相应的信息,其属性如表
.wxml
.js
运行效果
9.textarea
textarea组件为多行输人框组件,可以实现多行内容的输入。textarea组件的属性如表
10.label
label 组件为标签组件,用于提升表单组件的可用性。label组件支持使用for 属性找到对应的id或者将控件放在该标签下,当点击label组件时就会触发对应的控件。for属性的优先级高于内部控件,内部有多个控件的时候默认触发第一个控件。目前,label 组件可以绑定的控件有<buttow>< checkbox/>,<radio/>,<switch>
11.form
fomm组件为表单组件,用来实现将组件内的用户输人信息进行提交。当<form/>表单中formType为submit 的<button/>组件时,会将表单组件中的 value 值进行提交。fomm 组件的属性表
4.5多媒体组件
1. 缩放模式
scaleToFill不保持纵横比缩放图片,使图片的宽高完全拉伸至填满image元素。 aspectFit保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以将图片完整地显示出来。
aspectFill保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,在另一个方向将会发生截取。
widthFix宽度不变,高度自动变化,保持原图宽高比不变。
2.裁剪模式
top 不缩放图片,只显示图片的顶部区域。 bottom不缩放图片,只显示图片的底部区域。 center 不缩放图片,只显示图片的中间区域。 left不缩放图片,只显示图片的左边区域。 right 不缩放图片,只显示图片的右边区域。
top_left不缩放图片,只显示图片的左上边区域。 top_right不缩放图片,只显示图片的右上边区域。 bottom_left不缩放图片,只显示图片的左下边区域。 bottom_right不缩放图片,只显示图片的右下边区域。
4.5.2 audio
audio组件用来实现音乐播放,暂停等其属性表
4.5.3 video
video组件用来实现视屏播放,暂停等视频的默认宽度为300px,高度为225px,video组件的属性如下表
4.5.4 camera
camera 组件为系统相机组件,可以实现拍照或录像功能。在一个页面中,只能有一个camera组件。在开发工具中运行时,使用电脑摄像头实现拍照或录像;在手机中运行时,使用手机前后摄像头实现拍照或录像。 camera 组件的属性如表
4.6其他组件
在小程序中,除了前面介绍的组件以外,map组件和canvas组件比较常用。
4.6.1 map
map组件用于在页面中显示地图或路径,常用于LBS(基于位置服务)或路径指引,rot
能相对百度地图、高德地图较简单,目前具备绘制图标、路线、半径等能力,不能在croll
view、swiper、picker - view、movable - view组件中使用。 wi
map组件的属性如表
map组件的markers属性用于在地图上显示标记的位置,其相关属性如表
map组件的polyline 属性用来指定一系列坐标点,从数组第一项连线到最后一项,形成一条路线,可以指定线的颜色、宽度、线型以及是否带箭头等,其相关属性如表。
4.6.2 canvas
canvas 组件用来绘制图形,相当于一块无色透明的普通图布。canvas组件本身并没有绘图能力,仅仅是图形容器,通过绘图API实现绘图功能。在默认情况下,canvas组件的默认
宽度为 300 px,高度为225px,同一页面中的canvas-id不能重复,否则会出错canvas组件属性如表。
5.1即速应用概述
5.1.1即速应用优势
1.开发简单的优势
2.行业模板多样种类齐全
3.丰富的功能组件和强大的管理后台
5.1.2即速应用界面介绍
1.菜单栏中的风格选项用于设置风格,“管理”选项用于进入后台管理“帮助”选项用于提示帮助“客服”选项用于进入客服界面,“历史”选项用来恢复前操作,“预览”选项用在pc端预览制作效果,“保存”选项用来保存已制作内容,“生成”选项用于实现小程序打包上线设置。
2,工具栏
工具栏包括“页面管理”“组件库”2个 注册 选项卡,“页面管理”实现添加页面和添加分组以及对某一页面进行改名、收藏、复制、删除操作。“组件库”有9个基础组件、7个布局组件、18个高级组件和2个其他组件。
3.编辑区
编辑区是用来制作小程序页面的主要区域,通过拖拽组件实现页面制作,右边的“前进”“后退”选项可以进行恢复操作,“模板”选项可以用来选择模板,“元素”选项可以用来显示页面中的组件及其层次关系,“数据”选项可以用来进行页面数据管理,“模块”选项可以用来选择模块。
4.属性面板
属性面板用来设置选定组件的属性及样式,包括“组件”和“组件样式”两个选项卡。“组件”选项卡用来设置组件内容及点击事件;“组件样式”选项卡用来设置组件的样式,不同组件有不同的样式需要设置。
二,组件库
1,文本制作点击组件库“文本”
2,右边显示“文本内容”输入标题
3,图片制作
4,点击添加图片
5,添加按钮,选择按钮类型,输入按钮内容,背景设置可选择图
6,标题组件,选择类型,输入
7,商品列表组件,选择列表类型,组件设置
8,视频组件,选择视频类型,点击下面的视频内容,点击视频库,点击添加视频
9,轮播组件,点击轮播项1,点击更换图片
10,公告组件,点击公告1输入内容
11,点击添加组件,选择需要的板块
5.2即速应用组件
即速应用提供了大量的组件供用户快速布局页面,包括7个布局组件、9个基本组件、18个高级组件和2个其他组件。
5.2.1 布局组件
布局组件用于设计页面布局,主要包括双栏、面板、自由面板、顶部导航、底部导航、分割线和动态分类。
1.双栏组件
双栏组件用来布局整体,它可以把一个区块分为两部分,操作时显示一个分隔的标志,便于操作,预览时则不会出现。双栏组件默认设置每个栏占50%总宽,也可以按实际需要调整比例。双栏里面可以添加基本的组件,从而达到整体的布局效果。双栏还可以嵌套双栏,即可以在其中的一个栏里嵌入一个双栏,从而将整体分成3部分(若需要将整体分成4部分,就再嵌套一个双栏,依次类推)。双栏组件的属性面板如图。
2.面板组件
面板组件相当于一个大画板,用户可以将很多基本(甚至高级)的组件(如文本组件、图片组件、按钮组件、标题组件、分类组件、音频组件、栏组件、计数组件等)放进面板组件里一起管理。面板组件的属性面板如图。
3.自由面板组件
自由面板组件是指放置在该面板内的组件可以自由拖动,调节组件大小。用户既可以向自由面板内拖入部分组件(包括文本组件、图片组件和按钮组件),也可以拖入任意相关容器组件,用于不规则布局。
4. 顶部导航组件
顶部导航组件固定于页面顶部,用于编辑顶部的导航。常用的手机应用在顶部有一条导航,上面写有手机应用App的名称或logo,以及返回键等。顶部导航组件的属性面板设置如图5-7所示。
5.底部导航组件
底部导航组件固定于页面底部,用于编辑底部的导航。底部导航组件的属性面板设置如图5-8所示。通过底部导航组件可以添加标签、删除标签,同时可以分别设置每个标签的名称、原始图片、点击图片及链接至某一页面;通过组件面板可以进行组件背景色、图片及文字的设置。底部导航组件的制作效果
6. 分割线组件
分割线组件被放置于任意组件之间,用于实现分割。分割线组件的属性面板如图所示。
7.动态分类组件
动态分类组件仅适用于电商、到店类小程序。用户通过选择动态分类组件的样式,可以实现顶部分类、侧边栏分类来展示应用数据、商品数据等。动态分类的二级有图模式只适用于电商类小程序。动态分类组件的属性面板如图。
悬浮窗
分类横滑,添加面板,点击类型商品,点击编辑配置
1.动态列表组件
动态列表组件是容纳基础组件来展示后台数据的容器,通过添加基础组件来展示对应的后台数据,其属性面板如图
要使用动态列表组件,必须在后台进行数据管理,单击“管理对象”按钮,进入管理
后台,
单击“新增数据对象” 按钮, 进入“数据对象列表” 页面, 如图所示。
单击“添加字段” 按钮, 添加相应字段, 如图所示。
单击“保存” 按钮并返回, 进入“对象管理” 页面, 如图 所示。
单击“数据管理” 按钮, 进入“数据管理” 页面, 如图所示。
单击“ + 添加数据” 按钮新建数据, 进入“添加数据” 页面, 如图\所示。
添加相应数据并保存, 继续添加所需数据, “数据管理” 页面如图所示。
退回到编辑页面, 为了方便布局, 拖拽“自由面板” 组件到动态列表中, 然后拖拽一个图片和两个文本组件到自由面板组件, 如图所示。
在动态列表属性面板的绑定数据对象中选择“羽绒服” 数据对象, 同时图片组件绑定数据对象样式字段, 文本组件分别绑定数据对象的名称和价格字段, 如图 所示。
2.个人中心组件
个人中心组件显示个人相关信息的组件, 包括图像、昵称、我的订单、收货地址、购物车等, 如图所示。
3.动态表单组件
动态表单组件相当于HTML 中的< form > 标签, 是一个容器组件, 可以添加子表单组件和基本组件, 用来收集用户提交的相关信息给后台数据对象。 动态表单组件的属性面板如图 所示。
4.评论组件
评论组件提供信息发布或回复信息的组件, 评论组件的属性面板如图 所示。
5.计数组件
计数组件可以用于点赞、统计浏览量等类似的计数功能。 计数组件的属性面板如图所示。
6.地图组件
地图组件用于显示指定地址的地图, 常用于实现定位及导航功能, 地图组件的属性面板如图 所示。
7.城市定位组件
城市定位组件通常与列表类组件搭配使用, 常见搭配有动态列表和商品列表。 例如, 城市定位组件与商品列表搭配, 可以实现通过城市定位来搜索出某具体位置信息下的商品列表。城市定位组件的属性面板如图
8.悬浮窗组件
悬浮窗组件的固定搭配有: 客服、我的订单、购物车、回到顶部。 悬浮窗组件通常出现在个人中心或商品列表页面, 其属性面板如图
4 .其他组件
其他组件包括音频组件和动态容器组件。
1.音频组件
音频组件用于播放音乐(每个页面有一个音频组件即可), 手动点击播放按钮后即可实现播放。 音频文件可以选择音频库中的音乐, 也可以上传本地音频进行更换, 音频组件的属性面板如图 所示。
2.动态容器组件
动态容器组件用于动态页面, 即所在页面绑定了数据对象。 动态容器组件中可以添加多种组件———文本组件、图片组件、按钮组件、标题组件、分类组件、音频组件、双栏组件、计数组件。 其中, 文本组件和图片组件可以绑定相应的数据对象字段(填充相应动态数据), 若有计数组件, 则会自动与动态容器关联。 动态容器组件的属性面板如图 所示。
3.即速应用后台管理器
即速应用后台提供了非常强大的后台管理, 开发者在后台进行修改操作就可以让数据即时更新, 开发者还可以通过后台来查看小程序数据管理、用户管理、商品管理、营销工具、多商家管理等功能。
1.数据管理
数据管理包括数据总览、访客分析和传播数据功能。 数据总览提供小程序总浏览量、昨日/ 今日访问量、总用户量、总订单数及浏览量曲线图, 如图 所示。
访客分析是以图例的形式来展示用户从微信的哪个模块来访问及访问的次数、比例、用户来源地区、用户访问时间及使用设备等, 便于管理者更好地做好营销工作。
传播数据主要是用于提供新老访客的比例, 以及访客使用哪些主要平台打开应用的次数及占比。
2.分享设置
分享设置主要提供可以分享应用的方式, 如图 所示。
3.用户管理
用户管理主要用于实现对用户进行添加、分组、群发消息、储值金充值、赠送会员卡等功能, 4.应用数据
应用数据是后台管理的主要内容, 前端组件(动态列表、动态表单) 的数据都是通过在应用数据中的数据对象来管理的, 类似通过数据库存放和管理数据。
5. 轮播管理
轮播管理是前端软播组件的后台数据管理器, 通过软播管理来设置前端软播组件展示的图片内容。
6. 分类管理
分类管理适用于电商、到店、应用数据。 分类管理可以通过选择动态分类组件样式来实现在顶部分类或侧边栏分类以展示应用数据、商品数据等效果。 动态分类的二级有图模式只适用于电商。
7. 商品管理
商品管理是后台管理的主要内容, 前端商品列表组件的数据来源于后台商品管理。 商品管理可以管理商品列表、积分商品、位置管理、支付方式、订单管理、拼团订单管理、订单统计、账单明细、运费管理和评价管理功能。
8.经营管理
经营管理主要包括子账号管理、手机端客户关系管理和短信接收管理, 便于管理者管理小程序的运营。
9.营销工具
营销工具是小程序营销推广的有力工具, 主要有会员卡、优惠券、积分、储值、推广、秒杀、集集乐、拼团活动、大转盘、砸金蛋、刮刮乐等。 这些营销工具都需要事前在后台合理设置后, 才能在活动中发挥更大的作用。
10.多商家管理
多商家管理是即速应用为有众多商家的商城(如“华东商城” “义乌商城” 等) 开设的管理功能, 方便管理者统计每家店铺的订单及进行收益分析。即速应用可以将小程序的代码打包, 该代码包可以通过微信开发者工具来对接微信小程序。
4.1. 打包
进入即速应用后台管理, 选择左边选项“分享设置” 按钮, 单击“微信小程序” 选项, 进入如图 所示的页面。
选择“代码包下载” 选项, 单击“确定” 按钮, 进入如图所示的页面。
通过“微信公众平台→小程序→设置→开发设置” 获取AppID 和AppSecret, 在“服务器配置” 中填写相关信息, 选择相应分类, 单击“打包” 按钮, 即可成功打包,
4.2 上传
打开微信Web 开发者工具, 新建项目, 并填写相关内容。 其中, 项目目录为下载包解压后的目录。
单击“确定” 按钮, 打开小程序代码, 编译无误后, 填写该项目的版本号, 单击“上传” 按钮即可实现该小程序代码上传。
上传成功后, 打开微信公众平台的“开发管理” 界面, 就可以看到该小程序的版本信息, 如图 所示。 待审核通过后, 即可在“微信” → “发现” → “小程序” 中搜索到该小程序。
第六章小程序
1.网络API
微信小程序处理的数据通常从后台服务器获取, 再将处理过的结果保存到后台服务器,这就要求微信小程序要有与后台进行交互的能力。 微信原生API 接口或第三方API 提供了各类接口实现前后端交互。
网络API 可以帮助开发者实现网络UPL 访问调用、文件的上传和下载、网络套接字的使用等功能处理。 微信开发团队提供了10个网络API 接口。
wx.request(Object) 接口 用于发起HTTPS 请求。
wx.uploadFile(Object) 接口 用于将本地资源上传到后台服务器。
wx.downloadFile(Object) 接口 用于下载文件资源到本地。
wx.connectSocket(Object) 接口 用于创建一个WebSocket 连接。
wx.sendSocketMessage(Object) 接口 用于实现通过WebSocket 连接发送数据。
wx.closeSocket(Object) 接口 用于关闭WebSocket 连接。
wx.onSocketOpen(CallBack) 接口 用于监听WebSocket 连接打开事件。
wx.onSocketError(CallBack) 接口 用于监听WebSocket 错误。
wx.onSocketMessage(CallBack) 接口 用于实现监听WebSocket 接收到服务器的消息事件。
wx.onSocketClose(CallBack) 接口 用于实现监听WebSocket 关闭。
1.发起网络请求
wx.request(Object) 实现向服务器发送请求、获取数据等各种网络交互操作, 其相关参数如表。
例如,通过wx.request(Object)获取百度(http://www.baidu.com)首页数据。(需要在微信公众平台小程序服务配置中的request合法域名http://www.baidu.com“) 。
2.上传文件
wx.uploadFile(Object) 接口用于将本地资源上传到开发者服务器, 并在客户端发起一个HTTPSPOST 请求, 其相关参数如表 所示。
通过wx.uploadFile(Object) , 可以将图片上传到服务器并显示。示例代码如下:
3.下载文件
wx.downloadFile(Object)接口用于实现从开发者服务器下载文件资源到本地, 在客户端直接发起一个HTTPGET请求, 返回文件的本地临时路径。 其相关参数如表所示。
例如,通过wx.downloadFile(Object)实现从服务器中下载图片,后台服务采用WAMP软件在本机搭建。
2.多媒体API
多媒体API 主要包括图片API、录音API、音频播放控制API、音乐播放控制API 等, 其目的是丰富小程序的页面功能。
1.图片API
图片API 实现对相机拍照图片或本地相册图片进行处理, 主要包括以下4 个API 接口:
wx.chooseImage(Object) 接口 用于从本地相册选择图片或使用相机拍照。
wx.previewImage(Object) 接口 用于预览图片。
wx.getImageInfo(Object) 接口 用于获取图片信息。
wx.saveImageToPhotosAlbum(Object) 接口 用于保存图片到系统相册。
1.选择图片或拍照
wx.chooseImage(Object) 接口用于从本地相册选择图片或使用相机拍照。 拍照时产生的临时路径在小程序本次启动期间可以正常使用, 若要持久保存, 则需要调用wx.saveFile 保存图片到本地。 其相关参数如表6-4所示。
若调用成功, 则返回tempFilePaths 和tempFiles, tempFilePaths 表示图片在本地临时文件路径列表。tempFiles 表示图片的本地文件列表, 包括path 和size。
2.预览图片
wx.previewImage(Object) 接口主要用于预览图片, 其相关参数如表6 -5 所示。
3.获取图片信息
wx.getImageInfo(Object)接口用于获取图片信息, 其相关参数如表6 -6 所示。
4.保存图片到系统相册
wx.saveImageToPhotosAlbum(Object) 接口用于保存图片到系统相册, 需要得到用户授权scope.writePhotosAlbum。 其相关参数如表6 -7 所示。
2. 录音API
录音API 提供了语音录制的功能, 主要包括以下两个API 接口:
wx.startRecord(Object) 接口 用于实现开始录音。
wx.stopRecord(Object) 接口 用于实现主动调用停止录音。
1.开始录音
wx.startRecord(Object) 接口用于实现开始录音。 当主动调用 wx.stopRecord(Object)接口或者录音超过1 分钟时, 系统自动结束录音, 并返回录音文件的临时文件路径。 若要持久保存, 则需要调用wx.saveFile()接口。 其相关参数如表所示。
2.停止录音
wx.stopRecord(Object) 接口用于实现主动调用停止录音。
3 .音频播放控制API
音频播放控制API 主要用于对语音媒体文件的控制, 包括播放、暂停、停止及audio 组件的控制, 主要包括以下3 个API:
wx.playVoice(Object)接口 用于实现开始播放语音。
wx.pauseVoice(Object)接口 用于实现暂停正在播放的语音。
wx.stopVoice(Object)接口 用于结束播放语言
1.播放语音
wx.playVoice(Object)接口用于开始播放语音, 同时只允许一个语音文件播放, 如果前一个语音文件还未播放完, 则中断前一个语音文件的播放。 其相关参数如表 所示。
2.暂停播放
wx.pauseVoice(Object)用于暂停正在播放的语音。再次调用wx.playVoice(Object)播放同一个文件时, 会从暂停处开始播放。 如果想从头开始播放, 则需要先调用wx.stopVoice(Object)。
3.结束播放
wx.stopVoice(Object)用于结束播放语音。
4 .音乐播放控制API
音乐播放控制API 主要用于实现对背景音乐的控制, 音乐文件只能是网络流媒体, 不能是本地音乐文件。 音乐播放控制API 主要包括以下8 个API:
wx.playBackgroundAudio(Object)接口 用于播放音乐。
wx.getBackgroundAudioPlayerState(Object)接口 用于获取音乐播放状态。
wx.seekBackgroundAudio(Object)接口 用于定位音乐播放进度。
wx.pauseBackgroundAudio() 接口 用于实现暂停播放音乐。
wx.stopBackgroundAudio() 接口 用于实现停止播放音乐。
wx.onBackgroundAudioPlay(CallBack) 接口 用于实现监听音乐播放。
wx.onBackgroundAudioPause(CallBack) 接口 用于实现监听音乐暂停。
wx.onBackgroundAudioStop(CallBack) 接口 用于实现监听音乐停止。
1.播放音乐
wx.playBackgroundAudio(Object)用于播放音乐, 同一时间只能有一首音乐处于播放状态, 其相关参数如表所示。
2.获取音乐播放状态
wx.getBackgroundAudioPlayerState(Object) 接口用于获取音乐播放状态, 其相关参数如表所示。
接口调用成功后返回的参数如表所示。
3. 控制音乐播放进度
wx.seekBackgroundAudio(Object)接口用于控制音乐播放进度, 其相关参数如表所示。
4.暂停播放音乐
wx.pauseBackgroundAudio() 接口用于暂停播放音乐。
5.停止播放音乐
wx.stopBackgroundAudio() 接口用于停止播放音乐。
6.监听音乐播放
wx.onBackgroundAudioPlay(CallBack) 接口用于实现监听音乐播放, 通常被wx.playBackgroundAudio(Object)方法触发, 在CallBack 中可改变播放图标。
7.监听音乐暂停
wx.onBackgroundAudioPause(CallBack)接口用于实现监听音乐暂停,通常被wx.pauseBackgroundAudio()方法触发。在CallBack中可以改变播放图标。
8.监听音乐停止
wx.onBackgroundAudioStop(CallBack)接口用于实现监听音乐停止,通常被音乐自然播放停止或wx.seekBackgroundAudio(Object)方法导致播放位置等于音乐总时长时触发。在CallBack中可以改变播放图标。
9.案例展示
在此,以小程序music为案例来展示音乐API的使用。该小程序的4个页面文件分别为music.wxml、music.wxss、music.json、和music.js。
3.文件API
从网络上下载或录音的文件都是临时保存的,若要持久保存,需要用到文件API。文件API提供了打开、保存、删除等操作本地文件的能力,主要包括以下5个API接口:
wx.saveFile(Object)接口用于保存文件到本地。
wx.getSaveFileList(Object) 接口用于获取本地已保存的文件列表。
wx.getSaveFileInfo(Object) 接口用于获取本地文件的文件信息。
wx.removeSaveFile(Object) 接口用于删除本地存储的文件。
wx.openDocument(Object) 接口用于新开页面打开文档,支持格式:doc、xls、ppt、pdf、docx、xlsx、ppts。
1.保存文件
wx.saveFile(Object)用于保存文件到本地, 其相关参数如表所示。
2.获取本地文件列表
wx.getSavedFileList(Object)接口用于获取本地文件已保存的文件列表,如果调用成功,则返回文件的本地路径、文件大小和文件保存时的时间戳(从1970/01/01 08:00:00到当前时间的秒数)文件列表。
3.获取本地文件的文件信息
wx.getSaveFileInfo(Object)接口用于获取本地文件的文件信息,此接口只能用于获取已保存到本地的文件,若需要获取临时文件信息,则使用wx.getFileInfo(Object)接口。
4.删除本地文件
wx.removeSaveFile(Object)接口用于删除本地存储的文件
5.打开文档
wx.openDocument(Object)接口用于新开页面打开文档,支持格式:doc、xls、ppt、pdf、docx、xlsx、ppts。
wx.openDocument(Object) 相关参数
6.4 本地数据及缓存API
小程序提供了以键值对的形式进行本地数据缓存功能,并且是永久存储的,但最大不超过10MB,其目的是提高加载速度。数据缓存的接口主要有4个:
wx.setStorage( Object)或wx.setStorageSync( key ,data)接口用于设置缓存数据。 wx.getStorage(Object)或wx.getStorageSync(key)接口用于获取缓存数据。
wx.removeStorage( Object)或wx.removeStorageSyne(key)接口用于删除指定缓存数据。
wx.clearStorage( )或wx.clearStorageSync()接口用于清除缓存数据。其中,带Syne后缀的为同步接口,不带Sync后缀的为异步接口。
6.4.1保存数据
1.wx.setStorage(Object)
wx.setStorage(Object)接口将数据存储到本地缓存接口指定的key中,接口执行后会覆盖原来key对应的内容。
2,wx.setStoragesync(key,data)
wx.setStoragesync(key,data)是同步接口,其参数只有key和data。
6.4.2获取数据
1.wx.getStorage(Object)
wx.getStorage(Object)接口是从本地缓存中异步获取指定key对应内容。其参数如下:
2,wx.setStorageSync(key)从本地缓存中同步获取指定key对应内容。其参数只有key。
6.4.3删除数据
1.wx.removeStorage(Object)
wx.removeStorage(Object)接口用于从本地缓存中异步移除指定key。其相关参数如表:
2.wx.clearStorage()
wx.clearStorage()接口用于异步清理本地数据缓存。没有参数。
6.4.4清空数据
1.wx.clearStorageSync()
wx.clearStorageSync()接口用于同步清理本地数据缓存。
代码如下:
6.5 位置信息 API
小程序可以通过位置信息API来获取或显示本地位置信息,小程序支持WCS84和GCj02标准,WGS84标准为地球坐标系,是国际上通用的坐标系;GCj02标准是中国国家测绘局制定的地理信息系统的坐标系统,是由WGS84坐标系经加密后的坐标系,又称为火星坐标系。默认为WGS84标准,若要查看位置需要使用GCj02标准。主要包括以下3个API接口:
wx. getLocation( Object)接口用于获取位置信息。 wx. chooseLocation(Object)接口用于选择位置信息。 wx.openLocation(Object)接口用于通过地图显示位置。
6.5.1 获取位置信息
wx. getLocation(Object)接口用于获取当前用户的地理位置、速度,需要用户开启定位功能,当用户离开小程序后,无法获取当前的地理位置及速度,当用户点击“显示在聊天顶部”时,可以获取到定位信息,其相关参数如表。
wx. getLocation(Object)
wx. getLocation(Object)成功返回相关信息
6.5.2选择位置信息
wx.chooseLocation(Object)接口用于在打开的地图中选择位置,用户选择位置后可返回当前位置的名称、地址、经纬度信息。其相关参数如表6-24所示。
wx.chooseLocation(Object)相关参数
wx.chooseLocation(Object)成功返回相关信息
6.5.3显示位置信息
wx.openLocation(Objiect)接口用于在微信内置地图中显示位置信息,其相关参数如表
wx.openLocation(Objiect)相关参数
6.6设备相关API
设备相关的接口用于获取设备相关信息,主要包括系统信息、网络状态、拨打电话及扫码等。主要包括以下5个接口API:
wx. getSystemInfo( Object)接口、wx. getSystemInfoSync()接口用于获取系统信息。 wx. getNetworkType(Object)接口用于获取网络类型。
wx.onNetworkStatusChange (CallBack)接口用于监测网络状态改变。 wx.makePhoneCall(Object)接口用于拨打电话。 wx.scanCode(Object)接口用于扫描二维码。
6.6.1 获取系统信息
wx. getSystemInfo( Object )接口、wx.getSystemInfoSync()接口分别用于异步和同步获取系统信息。其相关参数如表6-27所示。
wx.getSystemInfo
wx.getSystemInfo()接口或wx.getDSystemInfoSync()成功返回相关信息
6.6.2网络状态
1.获取网络状态
wx.getNetworkType(Object)用于获取网络类型。其相关参数如表6-29
如果wx.fetNetworkType()接口被成功调用,则返回网络类型包,有wifi,2G,3G,4G,unknowmn(Adroid下不常见的网络类型),none(无用网络)。
2.监听网络状态变化
wxonNetworkStatusChange(CallBack)接口用于监听网络状态变化,当网络状态变化时,返回当前网络状态类型即是否有网络连接。
6.6.3拨打电话
wx.makePhoneCall(Object)接口用于实现调用手机拨打电话,其相关参数如表
6.6.4扫描二维码·
wx.scanCode(Object)接口用于调起客户端扫码界面,扫码成功后返回相关的内容,其相关参数如表
wx.scanCode(Object)相关参数
wx.scanCode(Object)成功返回相关信息