当前位置:   article > 正文

微信小程序项目实战_微信小程序项目实例

微信小程序项目实例

目录

小程序前后端交互

自定义组件的使用

语法说明

properties 定义

案例 

微信小程序的事件对象

e.target和e.currentTarget

 微信小程序的事件传参

传参方式一: data-key='value'

传参方式二: id='value'

scroll-view 使用

 scroll-view 中使用flex布局

scroll-into-view

下拉刷新 上拉加载

微信小程序分享功能的实现方法有两种:

微信音乐播放器

页面 布局

组件共享PubSubJS

小程序使用 npm 包

背景音频api使用说明

代码示例

小程序分包流程

为什么要分包

分包形式

常规分包

独立分包

分包预下载

支付流程详细说明

 小程序获取用户唯一标识(openId)


小程序前后端交互

语法说明

  • 每个微信小程序需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信
  • 服务器域名请在 「小程序后台-开发-开发设置-服务器域名」 中进行配置
  • 默认超时时间和最大超时时间都是 60s
  • 超时时间可以在 app.json 中通过 networktimeout 配置
  • 小程序为了安全起见只支持 Https 请求 wx.request 最大并发限制 10
  • 开发中可以在微信开发工具中不校验合法域名

  1. export default (url,data={},method='GET')=>{
  2. return new Promise((resolve,reject)=>{
  3. wx.request({
  4. url:'http://localhost:3000'+url,
  5. data,
  6. success:(res)=>{
  7. resolve(res.data)
  8. },
  9. fail:(err)=>{
  10. reject(err)
  11. }
  12. })
  13. })
  14. }

自定义组件的使用

语法说明

新建component组件 不会生路径

在使用的父页面 json中 usingComponents注册组件

父传值通过属性 title="排行榜" 子组件 properties 接收

properties 定义

api 框架----》自定义组件

定义段类型是否必填描述最低版本
type属性的类型
optionalTypesArray属性的类型(可以指定多个)2.6.5
value属性的初始值
observerFunction属性值变化时的回调函数

案例 

子组件

  1. <view class="header">
  2. <text class="title">{{title}}</text>
  3. <view>
  4. <text>{{nav}}</text>
  5. <text class="more"> 查看更多</text>
  6. </view>
  7. </view>
  8. // pages/index/commponents/NavHeader/NavHeader.js
  9. Component({
  10. /**
  11. * 组件的属性列表
  12. */
  13. properties: {
  14. title:{
  15. type:String,
  16. value:'默认值'
  17. },
  18. nav:{
  19. type:String,
  20. value:'默认值'
  21. }
  22. },
  23. })

父组件

  1. {
  2. "usingComponents": {
  3. "NavHeader":"../index/commponents/NavHeader/NavHeader"
  4. }
  5. }
  6. <NavHeader title="推荐歌曲" nav='为你精心推荐'></NavHeader>

微信小程序的事件对象

e.target和e.currentTarget

在小程序的事件回调触发时,会接收一个事件对象,事件对象的参数中包含一个target和currentTarget属性,接下来说说这二者的区别。

  1. <view id='tar-father' bindtap='click'>
  2. 父组件
  3. <view id='tar-children'>子组件</view>
  4. </view>

event.target 为其子组件,也就是触发该事件的源头组件, event.target 为父组件,因为触发的源头也就是父组件本身

event.currentTarget 为事件所绑定的组件  event.currentTarget 始终为事件所绑定的组件

总结:target对应的是触发事件的源头组件,这个组件有可能是子组件,有可能是父组件,主要是看执行动作的区域。而currentTarget始终对应事件所绑定的组件。

 微信小程序的事件传参

1. 什么是事件委托
    将子元素的事件委托(绑定)给父元素
2. 事件委托的好处(ul 下面的100li需要添加事件,可以直接绑定再父元素上)
   1. 减少绑定的次数
   2. 后期新添加的元素也可以享用之前委托的事件
3. 事件委托的原理
   1. 冒泡
4. 触发事件的是谁
   1. 子元素
5. 如何找到触发事件的对象
   1. event.target
6. currentTarget VS target
   1. currentTarget要求绑定事件的元素一定是触发事件的元素
   2. target绑定事件的元素不一定是触发事件的元素

传参方式一: data-key='value'

ps:key 可以自定义 传递多个

  1. <input class="" data-key="phone" placeholder="请输入用户名" bindinput="change"> </input>
  2. <input class="" data-key="password" placeholder="请输入用户名" bindinput="change" > </input>
  3. #js
  4. change(evet) {
  5. console.log(evet);
  6. let value = evet.detail.value
  7. let type = evet.currentTarget.dataset.key
  8. this.setData({
  9. [type]: value
  10. })
  11. },

传参方式二: id='value'

唯一值

  1. <input class="" id="phone" placeholder="请输入用户名" bindinput="change"> </input>
  2. <input class="" id="password" placeholder="请输入用户名" bindinput="change" > </input>
  3. #js
  4. change(evet) {
  5. console.log(evet);
  6. let value = evet.detail.value
  7. let type = evet.currentTarget.id
  8. this.setData({
  9. [type]: value
  10. })
  11. },

scroll-view 使用

tips y轴滚动时要计算滚动高度

 scroll-view 中使用flex布局

 enable-flex

启用 flexbox 布局。开启后,当前节点声明了 display: flex 就会成为 flex container,并作用于其孩子节点。

scroll-view 开启display:flex 设置 enable-flex 必须设置大小否则 scroll-view报错纵向布局高度

  1. <scroll-view class="scroll" enable-flex scroll-x>
  2. <view class="scrollItem" wx:for='{{recommendList}}' wx:key='id'>
  3. <image src="{{item.picUrl}}"></image>
  4. <text>{{item.name}}</text>
  5. </view>
  6. </scroll-view>
  7. .scroll{
  8. display: flex;
  9. height: 300rpx;
  10. }

scroll-into-view

值应为某子元素id(id不能以数字开头)。设置哪个方向可滚动,则在哪个方向滚动到该元素

scroll-into-view 是 scroll-view 的一个属性,主要作用是用于滚动到指定元素的位置,其对应值是元素的id,使用方法如下:

  1. <scroll-view
  2. class="navScroll"
  3. scroll-x
  4. enable-flex
  5. scroll-into-view="{{'scroll' + navid}}"
  6. >
  7. <view class="navItem" id="{{'scroll' + item.id}}"wx:for='{{GroupList}}' wx:key='id'>
  8. <view class="navContent {{navid==item.id?'active':''}}" bindtap='navChange' id="{{item.id}}">
  9. {{item.name}}
  10. </view>
  11. </view>
  12. </scroll-view>
  13. data: {
  14. GroupList: [],
  15. navid: '',
  16. VideoList: [],
  17. isTriggered: false //下拉刷新
  18. },
  19. //tags切换
  20. navChange(event) {
  21. // 保存点击id ,视频列表赋值为空
  22. this.setData({
  23. navid: event.currentTarget.id,
  24. VideoList: []
  25. })
  26. //开启加载提示,发送请求
  27. wx.showLoading({
  28. title: '正在加载',
  29. })
  30. this.getVideoList(event.currentTarget.id)
  31. },

下拉刷新 上拉加载

下拉刷新

refresher-enabled:开启自动义下拉刷新

定义下拉刷新时触发回调 bindrefresherrefresh

refresher-triggered 设置当前下拉刷新状态,true 表示下拉刷新已经被触发,false 表示下拉刷新未被触发 控制刷新状态

上拉触底

bindscrolltolower定义上拉触底时触发回调

  •         //为了实现下拉加载数据 1.后端分页 2.前端分页
  •         // 1.后端分页 一般触发请求 告诉后端第几页 和条目数
  •         // 2.前端分页 直接返回100条 第一次1-9 触底之后10-19

  1. //下拉刷新
  2. handleRefresher() {
  3. console.log('下拉刷新');
  4. this.getVideoList(this.data.navid)
  5. },
  6. // 上拉触底
  7. handleToLower() {
  8. console.log('上拉触底');
  9. let list=this.data.VideoList
  10. list.push(...list)
  11. this.setData({
  12. VideoList:list
  13. })
  14. }
  15. data: {
  16. GroupList: [],
  17. navid: '',
  18. VideoList: [],
  19. isTriggered: false //下拉刷新
  20. },
  21. <scroll-view
  22. class="view-scroll"
  23. scroll-y
  24. refresher-enabled
  25. bindrefresherrefresh="handleRefresher"
  26. bindscrolltolower="handleToLower"
  27. refresher-triggered="{{isTriggered}}"
  28. >
  29. <view class="vieoItem" wx:for='{{VideoList}}' wx:key='index'>
  30. <video src="{{item.data.previewUrl}}"> </video>
  31. </scroll-view>

微信小程序分享功能的实现方法有两种:

第一种

在page.js中实现onShareAppMessage,便可在小程序右上角选择分享该页面

监听用户点击页面内转发按钮(button 组件 open-type="share")或右上角菜单“转发”按钮的行为,并自定义转发内容。

参数类型说明最低版本
fromString转发事件来源。
button:页面内转发按钮;
menu:右上角转发菜单
1.2.4
targetObject如果 from 值是 button,则 target 是触发这次转发事件的 button,否则为 undefined1.2.4
webViewUrlString页面中包含web-view组件时,返回当前web-view的url1.6.4
  1. onShareAppMessage: function () {
  2. return {
  3. title: '弹出分享时显示的分享标题',
  4. desc: '分享页面的内容',
  5. path: '/page/user?id=123' // 路径,传递参数到指定页面。
  6. }
  7. }

判读用户点击的是那个

  1. onShareAppMessage: function ({from}) {
  2. console.log(from);
  3. if(from === 'button'){
  4. return {
  5. title: '来自button的转发',
  6. page: '/pages/video/video',
  7. imageUrl: '/static/images/nvsheng.jpg'
  8. }
  9. }else {
  10. return {
  11. title: '来自menu的转发',
  12. page: '/pages/video/video',
  13. imageUrl: '/static/images/nvsheng.jpg'
  14. }
  15. }
  16. }

第二种

自定义按钮实现分享,在page中添加一个带有open-type='share'的button标签

点击该按钮后,即会自动触发已经在page.js中定义好的onShareAppMessage方法,实现分享功能。

(<button open-type='share'></button>)。

如上例,path属性指向的是user页面,并附带id=123的参数。我们只需在user.js的onLoad函数中,通过options查看传递过来的参数:

  1. // user.js
  2. Page({
  3. onLoad: function(options) {
  4. console.log(options);
  5. }
  6. })

微信音乐播放器

页面 布局

  1. <!-- 进度条控制区域 -->
  2. <view class=".progerss">
  3. <text>{{currentTime}}</text>
  4. <!-- 总进度 -->
  5. <cview class="bar">
  6. <!-- 实时进度 -->
  7. <view class="audio-bar" style="width: {{width + 'rpx'}}">
  8. <!-- 小圆球 -->
  9. <view class="audio-circle" ></view>
  10. </view>
  11. </cview>
  12. <text>{{endTime}}</text>
  13. </view>
  14. <!-- 底部控制播放区域 -->
  15. <view class="musicControl">
  16. <text class="iconfont icon-iconsMusicyemianbofangmoshiShuffle"></text>
  17. <text class="iconfont icon-shangyishou" id="pre" bindtap='handleSwitch'></text>
  18. <text class="iconfont {{isPlay?'icon-zanting': 'icon-bofang'}} big" bindtap="handleMusicPlay"></text>
  19. <text class="iconfont icon-next" id="next" bindtap='handleSwitch'></text>
  20. <text class="iconfont icon-iconsMusicyemianbofangmoshiPlayList"></text>
  21. </view>
  22. </view>
  23. .musicControl {
  24. position: absolute;
  25. width: 100%;
  26. bottom: 40rpx;
  27. left: 0;
  28. display: flex;
  29. border-top: 1px solid #ffffff;
  30. }
  31. .musicControl text {
  32. width: 20%;
  33. height: 120rpx;
  34. line-height: 120rpx;
  35. text-align: center;
  36. color: #ffffff;
  37. font-size: 50rpx;
  38. }
  39. .musicControl text .big {
  40. font-size: 80rpx;
  41. }
  42. /* 进度条 */
  43. .progerss {
  44. width: 640rpx;
  45. height: 80rpx;
  46. line-height: 80rpx;
  47. display: flex;
  48. position: absolute;
  49. bottom: 200rpx;
  50. }
  51. .progerss .bar {
  52. position: relative;
  53. width: 450rpx;
  54. height: 8rpx;
  55. background: rgba(0, 0, 0, .4);
  56. margin: auto;
  57. }
  58. .bar .audio-bar {
  59. position: absolute;
  60. top: 0;
  61. left: 0;
  62. height: 8rpx;
  63. background-color: red;
  64. z-index: 99;
  65. }
  66. .audio-circle {
  67. position: absolute;
  68. right: -18rpx;
  69. top: -6rpx;
  70. width: 18rpx;
  71. height: 18rpx;
  72. border-radius: 50%;
  73. background-color: #fff;
  74. }

组件共享PubSubJS

1.使用第三方库: pubsub-js

2. 安装: npm install pubsub-js

3. 使用:

  • a) Import PubSub from ‘pubsub-js’
  • b) 订阅消息: PubSub.subscribe(‘eventName’, callback)
  • c) 发布消息: PubSub.publish(‘eventName’, data)
  • d) 取消订阅: PubSub.unsubscribe(‘eventName’)

小程序使用 npm

  • 初始化 package.json     npm init
  • 勾选允许使用 npm
  • 下载 npm
  • 构建 npm 1. 开发工具 ---> 工具 ---> 构建 npm   2. 会将 node_modules 中的包打包到 miniprogram_npm 中

背景音频api使用说明

  • BackgroundAudioManager 获取实例
  • BackgroundAudioManager.onPlay(function callback) 监听背景音频播放事件
  • BackgroundAudioManager.onPause(function callback) 监听背景音频暂停事件
  • BackgroundAudioManager.onStop(function callback) 监听背景音频停止事件
  • BackgroundAudioManager.onTimeUpdate(function callback) 监听背景音频播放进度更新事件,只有小程序在前台时会回调
  • BackgroundAudioManager.onEnded(function callback) 监听背景音频自然播放结束事件
  • BackgroundAudioManager.stop() 停止音乐
  • BackgroundAudioManager.pause() 暂停音乐

string src

音频的数据源(2.2.3 开始支持云文件ID)。默认为空字符串,当设置了新的 src 时,会自动开始播放,目前支持的格式有 m4a, aac, mp3, wav。

number startTime

音频开始播放的位置(单位:s)。

string title

音频标题,用于原生音频播放器音频标题(必填)。原生音频播放器中的分享功能,分享出去的卡片标题,也将使用该值。

number currentTime

当前音频的播放位置(单位:s),只有在有合法 src 时返回。(只读)

代码示例

  1. //获取全局app应用实例
  2. const app = getApp()
  3. import PubSub from 'pubsub-js'
  4. import request from '../../utils/request'
  5. import moment from 'moment'
  6. Page({
  7. data: {
  8. isPlay: false,
  9. song: {},
  10. id: '',
  11. linkUrl: '',
  12. currentTime: '00:00',
  13. endTime: '00:00',
  14. width: 0
  15. },
  16. onLoad: function (options) {
  17. this.setData({
  18. id: options.id
  19. })
  20. this.getMusicInfo(options.id)
  21. //判断当前音乐是否在播放
  22. console.log(app.globalData.musicId, app.globalData.isMUsicPlay + '全局de', options.id + '点击');
  23. if (app.globalData.isMUsicPlay && app.globalData.musicId == options.id) {
  24. this.setData({
  25. isPlay: true
  26. })
  27. }
  28. //创建音乐播放的实例对象
  29. this.getBackgroundAudioManager = wx.getBackgroundAudioManager()
  30. // 监听用户点击操作系统的播放暂停
  31. this.getBackgroundAudioManager.onPlay(() => {
  32. this.changePlayStatus(true)
  33. app.globalData.musicId = options.id
  34. })
  35. this.getBackgroundAudioManager.onPause(() => {
  36. this.changePlayStatus(false)
  37. })
  38. this.getBackgroundAudioManager.onStop(() => {
  39. this.changePlayStatus(false)
  40. })
  41. // 监听音乐实时播放进度
  42. this.getBackgroundAudioManager.onTimeUpdate(() => {
  43. // 实时时长
  44. let time = this.getBackgroundAudioManager.currentTime
  45. // 总时长
  46. let totalTime = this.getBackgroundAudioManager.duration
  47. let currentTime = moment(time * 1000).format('mm:ss')
  48. let width = time / totalTime * 450
  49. this.setData({
  50. currentTime,
  51. width
  52. })
  53. })
  54. //监听音乐播放自然结束
  55. this.getBackgroundAudioManager.onEnded(() => {
  56. //自动换至下一首音乐,并自动播放
  57. PubSub.publish('SwitchType', 'next');
  58. //将进度条长度恢复为0
  59. this.setData({
  60. width: 0,
  61. endTime: '00:00'
  62. })
  63. })
  64. },
  65. //获取音乐详情
  66. async getMusicInfo(ids) {
  67. let {
  68. songs
  69. } = await request('/song/detail', {
  70. ids
  71. })
  72. //转换总实长
  73. let endTime = moment(songs[0].dt).format('mm:ss')
  74. this.setData({
  75. song: songs[0],
  76. endTime
  77. })
  78. wx.setNavigationBarTitle({
  79. title: this.data.song.name,
  80. })
  81. },
  82. //修改状态功能函数
  83. changePlayStatus(isPlay) {
  84. this.setData({
  85. isPlay
  86. })
  87. //修改应用全局状态
  88. app.globalData.isMUsicPlay = isPlay
  89. },
  90. // 点击开始暂停按钮
  91. handleMusicPlay() {
  92. let isPlay = !this.data.isPlay
  93. this.setData({
  94. isPlay
  95. })
  96. let {
  97. id,
  98. linkUrl
  99. } = this.data
  100. this.musicControl(isPlay, id, linkUrl)
  101. },
  102. // 播放 暂停 功能回调
  103. async musicControl(isPlay, id, linkUrl) {
  104. //性能优化: 没有url时再去请求 有的时候就拿全局变量
  105. if (!linkUrl) {
  106. let {
  107. data
  108. } = await request('/song/url', {
  109. id
  110. })
  111. linkUrl = data[0].url
  112. this.setData({
  113. linkUrl
  114. })
  115. }
  116. if (isPlay) { //播放
  117. // 必须给实例添加url 和title
  118. this.getBackgroundAudioManager.src = linkUrl
  119. this.getBackgroundAudioManager.title = this.data.song.name
  120. } else { //暂停
  121. this.getBackgroundAudioManager.pause()
  122. }
  123. },
  124. // 点击切歌的回调
  125. handleSwitch(e) {
  126. let type = e.currentTarget.id
  127. //关闭当前音乐
  128. this.getBackgroundAudioManager.stop()
  129. //发布消息
  130. PubSub.publish('SwitchType', type);
  131. //订阅消息拿到回传id
  132. PubSub.subscribe('musiceId', (msg, id) => {
  133. console.log(msg, id);
  134. //获取音乐信息
  135. this.getMusicInfo(id)
  136. //自动播放
  137. this.musicControl(true, id)
  138. //接收到之后取消订阅
  139. PubSub.unsubscribe('musiceId');
  140. })
  141. }
  142. })

小程序分包流程

为什么要分包

  • 1. 小程序要求压缩包体积不能大于 2M,否则无法发布
  • 2. 实际开发中小程序体积如果大于 2M 就需要使用分包机制进行发布上传
  • 3. 分包后可解决 2M 限制,并且能分包加载内容,提高性能
  • 4. 分包后单个包的体积不能大于 2M
  • 5. 分包后所有包的体积不能大于 16M

分包形式

  • 1. 常规分包
  • 2. 独立分包
  • 3. 分包预下载

常规分包

1. 开发者通过在 app.json subpackages 字段声明项目分包结构

2. 特点:

a) 加载小程序的时候先加载主包,当需要访问分包的页面时候才加载分包内容

b) 分包的页面可以访问主包的文件,数据,图片等资源

c) 主包:

主包来源: 除了分包以外的内容都会被打包到主包中 通常放置启动页/tabBar 页面

  1. "subPackages":[
  2. {
  3. "root": "songPackge",
  4. "pages": [
  5. "pages/recommendSong/recommendSong",
  6. "pages/songDetail/songDetail"
  7. ]
  8. }
  9. ],

独立分包

1. 设置 independent true
2. 特点 :
a) 独立分包可单独访问分包的内容,不需要下载主包
b) 独立分包不能依赖主包或者其他包的内容
3. 使用场景
a) 通常某些页面和当前小程序的其他页面关联不大的时候可进行独立分包
b) 如:临时加的广告页 || 活动页

分包预下载

配置
a) app.json 中设置 preloadRule 选项
b) key( 页面路径 ): {packages: [ 预下载的包名 || 预下载的包的根路径 ])}
2. 特点 :
a) 在加载当前包的时候可以设置预下载其他的包
b) 缩短用户等待时间,提高用户体验

支付流程详细说明

  • 1. 用户在小程序客服端下单(包含用户及商品信息)
  • 2. 小程序客户端发送下单支付请求给商家服务器
  • 3. 商家服务器同微信服务器对接获取唯一标识 openID
  • 4. 商家服务器根据 openId 生成商户订单(包含商户信息)
  • 5. 商家服务器发送请求调用统一下单 API 获取预支付订单信息
  • a) 接口地址: https://api.mch.weixin.qq.com/pay/unifiedorder
  • 6. 商家对预支付信息签名加密后返回给小程序客户端
  • a) 签名方式: MD5
    b) 签名字段:小程序 ID, 时间戳, 随机串,数据包,签名方式
    c) 参考地址
    :
    https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=3
    7. 用户确认支付(鉴权调起支付)
    a) API: wx.requestPayment()
    8. 微信服务器返回支付结果给小程序客户端
    9. 微信服务器推送支付结果给商家服务器端

 小程序获取用户唯一标识(openId

1. wx.login()

  • 2. 发送 code 给服务器端
  • 3. 服务器端发送请求携带参数(code, appSecret, appId)给微信服务器获取 openId
  • a) 接口地址:
  • 4. appSecretappId 在小程序首页获取
  • 5. 服务器获取 openId 后进行加密返回给前端

 

声明:本文内容由网友自发贡献,转载请注明出处:【wpsshop博客】
推荐阅读
相关标签
  

闽ICP备14008679号