微信小程序开发踩坑记录
1.由于小程序wx.request()方法是异步的,在app.js执行ajax后,各分页加载app.js的全局数据时,无法按顺序加载。例:
//app.js App({ ajax:function(){ let that = this; wx.request({ url: \'https://a.com/url.php\', method: \'GET\', success: function(e){ that.data = 123; } }) }; }) //content.js let app = getApp() Page({ getData: function(){ app.ajax(); console.log(app.data); //undefined } })
解决方法,使用Promise异步函数:
//app.js App({ ajax:function(){ let that = this; let promise = new Promise(function(resolve, reject){ wx.request({ url: \'https://a.com/url.php\', method: \'GET\', success: function(e){ that.data = 123; resolve(); } }) }); }; }) //content.js let app = getApp() Page({ getData: function(){ app.ajax().then(()=>{ console.log(app.data); //123 }); } })
2.图片只能获取原始宽高,无法获取现有宽高。不过image标签封装了mode属性,可以根据需求自行设置。
3.每个image标签底部有一条透明间隔,非padding,非margin。在图片前面做遮罩层时可能会被坑。
设置css为vertical-align: middle; 就可以
4.网络请求必须部署https
5.配置tabBar时,list参数中的pagePath参数至少需要包含app.json里pages数组中的第一个路径,否则会导致tabBar不显示。
6.tabBar跳转时无法带参数,解决方法:
//search.js var app = getApp(); Page({ confirm: function(e){ //获取数据,添加到全局 let val = e.detail.value; app.searchWord = val; this.jump(); }, jump: function(){ //跳转tabBar wx.switchTab({ url: \'../index/index\', }); }, }); //index.js var app = getApp(); Page({ onShow: function(e){ //获取全局数据 let val = app.searchWord; } }); //需要传递参数的页面在跳转前将数据添加到app.js里。需要接受参数的页面在onShow方法接受之前添加到app.js的数据。
7.小程序wx.request()方法请求的url必须是https开头
8.wx.request()使用post方法请求时,还需要加上header,header[content-type]值为application/x-www-form-urlencoded。例:
wx.request({ url: \'https://a.com/url.php\', data: {message: 123}, method: \'POST\', header: { \'content-type\': \'application/x-www-form-urlencoded\' }, success: function(e){ console.log(e) } });
9.小程序无法加载html标签(现在可以用rich-text组件,但是对图片很不友好),同时数据渲染也无法渲染wxml标签(<view></view>等),可以使用wxParse.js来处理相关数据。
10.安卓无法渲染wx.request()请求的数据。官方已处理此坑
检测返回的数据是否有BOM头(3个字符的空白)。安卓的wx.request解析不会跳过BOM头,导致数据返回的是字符串,而不是对象或者数组。
例:
返回的数据是:(3个字符的空白){a:1, b:2}
解析的数据是:\'{a:1, b:2}\'(字符串),而不是{a:1, b:2}(对象)
由于不是对象,模板渲染之类会无法正常进行。解决方法,后台返回数据前去掉BOM头就行。如果后台不会去BOM头,可以在前端去除,但是wx.request如果dataType缺省,会默认为json并自动解析,导致无法去除BOM头。
解决方案:
wx.request({ url: url, method: \'GET\', dataType: \'txt\', success: function(e){ let json = e.data.trim(); let arr = JSON.parse(json); } });
dataType改为json以外的格式,避免小程序自动解析json字符串,然后对返回的数据用 trim() 方法去掉空白,最后解析json字符串就行。
11.调试时多行省略(-webkit-line-clamp)正常,发布时多行省略无效。
解决方案:如果不想重新审核,让后台截断就好
12.单次setData长度有限制:1048576
appservice:16 invokeWebviewMethod 数据传输长度为 2432088 已经超过最大长度 1048576
在用富文本的时候容易发生,特别是图片为base64且像素特别大的时候
13.页面的生命周期很迷,只有当redirectTo或navigateBack的时候才会卸载页面,也就是触发onUnload。
导致变量会存在很久,如果用setTimeout循环调用,可能会被坑,可以在onHide的时候清除有影响的变量或者setTimeout