前言
开发项目时,实际遇到的一些功能需求和问题汇总。列出了当时参考的一些文章和官方文档。
开发框架:mpvue
官方文档:5分钟快速上手
小程序跳转外链
参考文章:小程序跳转到非小程序页面的外部链接地址
- 要跳转的链接必须是https的
- 需要用web-view组件,web-view组件是一个可以用来承载网页的容器,会自动铺满整个小程序页面。(个人类型与海外类型的小程序暂不支持使用。也就是说个人申请的小程序,就别想跳转了)
- 需要在小程序后台配置业务域名,也就是你要跳转网页地址的域名。(设置-开发设置 -业务域名)
- 配置业务域名时,会要求下载校验文件,该文件需要放置到访问外链地址的根目录下,可能会需要运维协助
- 跳转外链后,如果打开的二级页中有新的域名地址,同样需要重复上述步骤
小程序内部页面跳转
官方文档:小程序页面跳转
低版本兼容
为便于开发者解决低版本基础库无法兼容小程序的新功能的问题,开发者可设置小程序最低基础库版本要求。
开发者可以登录小程序管理后台,进入「设置 - 基本设置 - 基础库最低版本设置」进行配置。在配置前,开发者可查看近 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)
监听用户点击页面内转发按钮(
官网文档: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举例
@change="handleChange($event)">
handleChange (e) {
// 这里获取参数
let oIndex = e.mp.detail.current
// 修改swiper展示index
store.commit('setCurMovieIndex', oIndex)
this.changeActive()
this.changeNormal()
},