复习篇（4~6章）

四、第四章（页面组件）

4.1、组件的定义及属性

4.2、容器视图组件

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

4.2.1、view

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

4.2.2、scroll-vie

        text组件用于展示内容，类似HTML中的<span>，text组件中的内容支持长按选中，支持转义字符“\”，属于行内元素。

4.2.3、swiper

        ​swjper组件可以实现轮播图 图片预览 滑动页面等效果 个完整的swiper组件由中只能放置
m/ 两个标签组成，它们不能单独使用 Nwiperwiner个成多个 awina 若放置其他组件则会被删除： <swiper =item/ 内部可以放置任何组件，默认宽高自动设置为100%。

4.3、基础内容组件

4.3.1、icon

       icon组件即图标组件，通常用于表示一种状态，如success info、warn、waiting、cancel等。

4.3.2、text

        text组件用于展示内容，类似HTML中的<span>，text组件中的内容支持长按选中，支持转义字符“\”，属于行内元素。

4.3.3、progress

       progress组件用于显示进度状态，如资源加载、用户资料完成度、媒体资源播放进度等。progress组件属于块级元素。

4.4、表单组件

4.4.1、button

4.4.2、radio

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

4.4.3、checkbox

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

4.4.4、switch

4.4.5、slider

4.4.6、picker

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

4.4.7、picker-view

4.4.8、input

4.4.9、textarea

4.4.10、label

4.4.11、from

4.5、多媒体组件

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

4.6、其他组件

4.6.1、map

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

4.6.2、canvas 

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

五、第五章（即速应用）

5.2、即速应用组件

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

5.2.1、 基本组件

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

5.2.2、布局组件

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

六、第六章（API应用）

6.1、网络API

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

       网络 API 可以帮助开发者实现网络URL访问调周用、文件的上传和下载、网络套接字的使用等功能处理。微信开发团队提供了10个网络A 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关闭。

6.1.1、发起网络请求

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

6.1.2、上传文件

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

6.1.3、下载文件

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

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保    
存图片到本地。

2、预览图片
wx. previewImage(Object)接口主要用于预览图片。

3、获取图片信息

wx.getImageInfo(Object) 接口用于获取图片信息。

4、保存图片到系统相册
     wx.savelmageToPhotosAlbum( 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、停止录音
   wI stopRecord( Object)接口用于实现主动调用停止录音。

 6.2.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)用于结束播放语音

6.2.4、音乐播放控制API

   音乐播放控制API主要用于实现对背景音乐的控制，音乐文件只能是网络流媒体，不能是本地音乐文件。音乐播放控制API主要包括以下8个API:

wx. playBackgroundAudio(Object)接口用于播放音乐。

wx. getBackgroundAudioPlayerState(Object)接口用于获取音乐播放状态。

wx. seekBackgroundAudio(Object)接口用于定位音乐播放进度。

wx. pauseBackgroundAudio()接口用于实现暂停播放音乐。

wx. stopBackgroundAudio( )接口用于实现停止播放音乐。

wx. onBackgroundAudioPlay(CallBack)接口用于实现监听音乐播放。

wx. onBackgroundAudioPause(CallBack)接口用于实现监听音乐暂停。

wx. onBackgroundAudioStop(CallBack)接口用于实现监听音乐停止。

1、播放音乐

     wx. playBackgroundAudio(Object)用于播放音乐，同一时间只能有一首音乐处于播放状态

2、获取音乐播放状态
    wx. getBackgroundAudioPlayerState(Object)    接口用于获取音乐播放状态

3、控制音乐播放进度

    wx.seekBackgroundAudio(Object)接口用于控制音乐播放进度

4、暂停播放音乐

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

5、停止播放音乐

wx.stopBackgroundAudio()接口用于停止播放音乐

6、监听音乐播放
     wx.onBackgroundAudioPlay( Ca allBack)接口用于实现监听音乐播放，通常被wx.playBack- groundAudio( Object)方法触发，在 CallBack 中可改变播放图标。

6.3、文件API

        从网络上下载或录音的文件都是临时保存的，若要持久保存，需要用到文件API。文件 API提供了打开、保存、删除等操作本地文件的能力，主要包括以下5个API接口:
wx. saveFile(Object)接口用于保存文件到本地。
wx. getSavedFileList(Object)接口用于获取本地已保存的文件列表。 wx. getSaveFileInfo( Object)接口用于获取本地文件的文件信息。 wx. removeSaveFile(Object)接口用于删除本地存储的文件。
wx. openDocument(Object)接口用于新开页面打开文档，支持格式:doc、xls、 ppt、pdf、docx、xlsx、ppts。
1、保存文件
wx. saveFile(Object)用于保存文件到本地

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

3、获取本地文件的文件信息
     wx getSaveFileInfo( Object)接口用于获取本地文件的文件信息，此接口只能用于获取已保存到本地的文件，若需要获取临时文件信息息，则使用wx.getFileInfo(Object)接口。

4.删除本地文件
wx.removeSaveFile(Object)接口用于删除本地存储的文件

5.打开文档
wx.openDocument(Object)接口用于新开页面打开文档，支持格式有doc、xls、ppt、pdf、docx、xlsx、pptx

6.4、本地数据及缓存API

         小程序提供了以键值对的形式进行本地数据缓存功能，并且是永久存储的，但最大不超过10MB，其目的是提高加载速度。数据缓存的接口主要有4个:

         wxsetStorage(Object)或wx.setStorageSyne (key,data)接口用于设置缓存数据。  

         wx. getStorage(Object)或wx.getStorageSync( key)接口用于获取缓存数据。

         wx. removeStorage( Object)或wx.removeStorageSync(key)接口用于删除指定缓存数据。

         wx.clearStorage( )或wx.clearStorageSync()接口用于清除缓存数据。其中，带Sync后缀的为同步接口，不带Syne后缀的为异步接口。

（1） 保存数据

1、wx.setStorage( Object)
        wx.setStorage(Object )接口将数据存储到本地缓存接口指定的key中，接口执行后会覆盖原来key对应的内容。

2、wx.setStorageSync( Object)

     wx.setStorageSync(key,data)是同步接口，其参数只有key和data

（2） 获取数据 

1、wx.setStorage( Object)
        wx.setStorage(Object )接口是从本地缓存中异步获取指定的key对应的内容。

2、wx.setStorageSync( key)
        wx.setStorage(key )接口是从本地缓存中同步获取指定的key对应的内容。

 （3） 删除数据

   1、wx.removeStorage(Object)

          wx.removeStorage(Object)接口用于从本地缓存异步移除指定key

2、wx.removeStorageSync( key)

    wx.removeStorageSync( key)接口用于从本地缓存中同步删除指定key对应的内容，其参数只有key。

（4） 清空数据

1、wx.clearStorage()

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

6.5、位置信息API

          小程序可以通过位置信息API来获取或显示本地位置信息，小程序支持WGS84和GCj02标准，WGS84标准为地球坐标系，是国际上通用的坐标系;GCj02标准是中国国家测绘局制定的地理信息系统的坐标系统，是由WGS84坐标系经加密后的坐标系，又称为火星坐标系。默认为WGS84标准，若要查看位置需要使用GCj02标准。主要包括以下3个API接口:

    wx. getLocation(Object)接口用于获取位置信息。

    wx. chooseLocation(Object)接口用于选择位置信息。

    wx. openLocation(Object)接口用于通过地图显示位置。

（1）获取位置信息

       wx.getLocation( Object)接口用于获取当前用户的地理位置、速度，需要用户开启定位功能，当用户离开小程序后，无法获取当前的地理位置及速度，当用户点击“显示在聊天顶
部”时，可以获取到定位信息.

（2）选择位置信息

       wx.chooseLocation( Object)接口用于在打开的地图中选择位置，用户选择位置后可返回当前位置的名称，地址，经纬度信息。

（3） 显示位置信息

       wx. openLocation(Object)接口用于在微信内置地图中显示位置信息

6.6、设备相关API

     设备相关的接口用于获取设备相关关信息，主要包括系统信息、网络状态、拨打电话及扫码等。主要包括以下5个接口API:

wx.getSystemInfo( Object)接口、wx. getSystemInfoSync()接口用于获取系统信息。

wx. getNetworkType( Object)接口用于获取网络类型。

wx.onNetworkStatusChange(Call Back)接口用于监测网络状态改变。

wx. makePhoneCall(Object)接口口用于拨打电话。

wx.scanCode(Object)接口用于扫描二维码。

（1）获取系统信息

wx. getSystemInfo( Object)接口、wx.getSys temInfoSync()接口分别用于异步和同步获取系统信息。

（2）网络状态

1.获取网络状态

wx.getNetworkType(Object)用于获取网络类型

（3）拨打电话

wx.makePhoneCall(Object)接口用于实现调用手机拨打电话

（4）扫描二维码

wx.scanCode(Object)接口用于调起客户端扫码界面，扫码成功后返回相应的内容