微信小程序部分功能踩坑指南

前言

开发项目时,实际遇到的一些功能需求和问题汇总。列出了当时参考的一些文章和官方文档。
开发框架:mpvue
官方文档:5分钟快速上手

小程序跳转外链

参考文章:小程序跳转到非小程序页面的外部链接地址

  1. 要跳转的链接必须是https的
  2. 需要用web-view组件,web-view组件是一个可以用来承载网页的容器,会自动铺满整个小程序页面。(个人类型与海外类型的小程序暂不支持使用。也就是说个人申请的小程序,就别想跳转了)
  3. 需要在小程序后台配置业务域名,也就是你要跳转网页地址的域名。(设置-开发设置 -业务域名)
  4. 配置业务域名时,会要求下载校验文件,该文件需要放置到访问外链地址的根目录下,可能会需要运维协助
  5. 跳转外链后,如果打开的二级页中有新的域名地址,同样需要重复上述步骤

小程序内部页面跳转

官方文档:小程序页面跳转

低版本兼容

为便于开发者解决低版本基础库无法兼容小程序的新功能的问题,开发者可设置小程序最低基础库版本要求。

开发者可以登录小程序管理后台,进入「设置 - 基本设置 - 基础库最低版本设置」进行配置。在配置前,开发者可查看近 30 天内访问当前小程序的用户所使用的基础库版本占比,以帮助开发者了解当前用户使用的情况。

官方文档:低版本兼容处理

微信小程序 基础库版本与客户端版本对应关系

小程序iphonex适配

参考文章:微信小程序API之设备获取系统信息getSystemInfo

参考文章:微信小程序适配iphoneX

mpvue支持less

参考文章:2步配置mpvue支持less

小程序生命周期

参考文章:小程序生命周期

官方文档:mpvue的生命周期

坑点:右上角按钮只是把小程序退到了后台,并没有关闭小程序,所以如果未做处理,下次进去还是上一次退出前的状态。不会像h5一样刷新打开页面。也没有开放销毁小程序的监听。
前台、后台定义: 当用户点击左上角关闭,或者按了设备 Home 键离开微信,小程序并没有直接销毁,而是进入了后台;当再次进入微信或再次打开小程序,又会从后台进入前台。

swiper 间距轮播

参考文章:微信小程序使用swiper组件实现类3D轮播图

参考文章:小程序swiper组件实现不同效果间距轮播

最后用的第二篇里面的方法三,需要用到Animation动画对象
第一篇文章里直接用css的transition,动画不流畅。

小程序swiper组件bug:

参考文章:微信小程序swiper组件卡死来回疯狂轮播

小程序引入外部字体

参考文章:小程序如何引入外部字体
用过里面的方法二

图片预览

只有图片全屏预览后,才能通过长按图片吊起菜单栏(保存图片,分享图片,收藏图片)

参考文章:图片预览

保存图片到相册

小程序保存图片到本地授权问题

// 保存图片
export function saveImg (imgurl) {
  wx.showLoading({
    title: '图片保存中...'
  })
  wx.downloadFile({
    url: imgurl,
    success: function (res) {
      // 图片保存到本地
      wx.saveImageToPhotosAlbum({
        filePath: res.tempFilePath,
        success: function (data) {
          wx.hideLoading()
          wx.showModal({
            title: '图片已存入相册',
            content: '好东西要分享,发给朋友们看看。',
            showCancel: false
          })
        },
        fail: function (err) {
          console.log(err)
          if (err.errMsg === 'saveImageToPhotosAlbum:fail:auth denied' || err.errMsg === 'saveImageToPhotosAlbum:fail auth deny' || err.errMsg === 'saveImageToPhotosAlbum:fail authorize no response') {
            // 这边微信做过调整,必须要在按钮中触发,因此需要在弹框回调中进行调用
            wx.showModal({
              title: '提示',
              content: '需要您授权保存相册',
              showCancel: false,
              success: modalSuccess => {
                wx.openSetting({
                  success (settingdata) {
                    console.log('settingdata', settingdata)
                    if (settingdata.authSetting['scope.writePhotosAlbum']) {
                      wx.showModal({
                        title: '提示',
                        content: '获取权限成功,再次点击按钮即可保存',
                        showCancel: false
                      })
                    } else {
                      wx.showModal({
                        title: '提示',
                        content: '获取权限失败,将无法保存到相册!',
                        showCancel: false
                      })
                    }
                  },
                  fail (failData) {
                    console.log('failData', failData)
                  },
                  complete (finishData) {
                    console.log('finishData', finishData)
                  }
                })
              }
            })
          }
        },
        complete (res) {
          wx.hideLoading()
        }
      })
    }
  })
}

转发小程序

1. 显示转发按钮

wx.showShareMenu(Object object)

  mounted () {
    wx.showShareMenu({
      withShareTicket: true
    })
  },
2. 自定义转发的标题、图片

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

官网文档:onShareAppMessage(Object)

mpvue中与mounted写的位置类似

  onShareAppMessage: function (options) {
    return sharehanle(options)
  },

处理设置菜单分享和按钮分享的自定义标题、图片等。

export function sharehanle (options) {
  // var that = this
  // 设置菜单中的转发按钮触发转发事件时的转发内容
  console.log(options)
  var shareObj = {
    title: '分享标题', // 默认是小程序的名称(可以写slogan等)
    path: '/pages/index/main', // 默认是当前页面,必须是以‘/’开头的完整路径
    imageUrl: '', // 自定义图片路径,可以是本地文件路径、代码包文件路径或者网络图片路径,支持PNG及JPG,不传入 imageUrl 则使用默认截图。显示图片长宽比是 5:4
    success: function (res) {
      // 转发成功之后的回调
      if (res.errMsg === 'shareAppMessage:ok') {
        console.log('分享成功')
      }
    },
    fail: function (res) {
      // 转发失败之后的回调
      if (res.errMsg === 'shareAppMessage:fail cancel') {
        // 用户取消转发
      } else if (res.errMsg === 'shareAppMessage:fail') {
        // 转发失败,其中 detail message 为详细失败信息
      }
    },
    complete: function () {
      // 转发结束之后的回调(转发成不成功都会执行)
    }
  }
  // 来自页面内的按钮的转发
  // if (options.from === 'button') {
  //   var eData = options.target.dataset
  //   console.log(eData.name) // shareBtn
  //   // 此处可以修改 shareObj 中的内容
  //   shareObj.path = '/pages/btnname/btnname?btn_name=' + eData.name
  // }
  // 返回shareObj
  return shareObj
}

export default {
  sharehanle
}

微信自带loading,提示和弹窗API

1. loading
显示
wx.showLoading({
    title: '图片保存中...'
})
隐藏
wx.hideLoading()
2. Modal
wx.showModal({
    title: '提示',
    content: '获取权限成功,再次点击按钮即可保存',
    showCancel: false
    })
3.Toast
wx.showToast({
  title: '提交成功',
  icon: 'succes',
  duration: 1000,
  mask: true
})

统计

官方文档

会用到的应该是自定义分析,也就是按钮点击等事件的统计。


其他

  • background-image只能用网络url或者base64.本地图片要用image标签才行。
  • 小程序里有视频播放,审核的时候会有资质问题,需使用封装的视频插件

  • 后台发送的模板消息,需要前端提交数据时,提供formId。详见小程序form组件

  • mpvue 事件的参数通过绑定是用$event传入
    以swiper举例

  <swiper class="sub_swiper"
    :indicator-dots="indicatorDots"
    :autoplay="autoplay"
    :interval="interval"
    :duration="duration"
    :previous-margin="previousMargin"
    :next-margin="nextMargin"
    :current ="curMovieIndex"
    <!--传入事件参数-->
    @change="handleChange($event)">
      <block v-for="(item, index) in datalist" :key="index">
          <swiper-item>
            <div class="item" :class="{'active_item': curMovieIndex === index }" :animation="index == curMovieIndex ? animationData : animationData2">
              <image class="img" :src="item.coverImg"></image>
            </div>
          </swiper-item>
      </block>
  </swiper>
    handleChange (e) {
     // 这里获取参数
      let oIndex = e.mp.detail.current
      // 修改swiper展示index
      store.commit('setCurMovieIndex', oIndex)
      this.changeActive()
      this.changeNormal()
    },
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,265评论 6 490
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,078评论 2 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 156,852评论 0 347
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,408评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,445评论 5 384
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,772评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,921评论 3 406
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,688评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,130评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,467评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,617评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,276评论 4 329
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,882评论 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,740评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,967评论 1 265
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,315评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,486评论 2 348