微信小程序开发中常见的踩坑记录与分析

why 296 2024-07-05

今天微信小程序开发教程栏目为大家记录微信小程序的踩坑。

记录微信小程序的踩坑(开发篇)

最近参与开发了公司的第一款小程序,开发体验基本类似于基于webview的混合式开发,可以调用官方强大的api,但也有一些坑或者说不习惯的地方。这篇文章从实用性出发,记录了开发过程中的一些问题:

1. 样式优先级混乱

在使用button组件时,发现在class中设置width不生效,下面贴上代码:

1

2

.my-button{  width: 140rpx;  height: 60rpx;  line-height: 60rpx;  padding: 0;

}复制代码

经过微信调试工具排查后,发现user agent的样式优先级居然大于我们自己写的样式类,这在浏览器中基本是不可能发生的事情

image.png

解决方案其实比较简单,给width添加!important的后缀或者style="width:140rpx"即可,修改后我们再看一下效果:

image.png

image.png

加上!important之后,其实宽度的实际效果已经符合我们的预期了,但是微信调试工具却仍然显示user agent样式优先,这应该算是调试工具的一个bug吧。

2. 普通UI组件封装,参数定义繁琐

一般UI视觉稿中的基础组件,例如button,是有特定样式的:比方说背景色/字体。利用小程序的Component函数封装成组件,编写默认样式并接收外部传入的class,可以方便后续开发。

React有这种写法,即组件接收props不做处理,只透传给下一个组件,但小程序不支持这种写法(苦搜无果,官方文档也没有说明)。

这就意味着我们需要把所有button组件支持的参数都罗列在properties中:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

properties: {

    classes: {

      type: String,

      value: '',

    },

    type: {

      type: String,

      value: 'default',

    },

    plain: {

      type: Boolean,

      value: false,

    },

    size: {

      type: String,

      value: 'default',

    },

    ......

  },复制代码

3. 全局样式选择器*被禁用

1

2

3

*{

  box-sizing: border-box;

}复制代码

上面的代码在编译的时候就会报错,因为小程序禁用了这类选择器。大胆猜测具体原因:这类作用范围比较广的选择器和自定义组件的样式隔离产生了冲突??

那怎么去给小程序添加全局通用样式?看来只能自己把用到的标签都手动写一遍了,还好网上有现成的代码可以贴:

1

2

view,scroll-view,swiper,swiper-item,movable-area,movable-view,cover-view,cover-image,icon,text,rich-text,progress,button,checkbox-group,checkbox,form,input,label,picker,picker-view,radio-group,radio,slider,switch,textarea,navigator,functional-page-navigator,image,video,camera,live-player,live-pusher,map,canvas,open-data,web-view,ad{  box-sizing: border-box;

}复制代码

4. 自定义组件,bind:tap调用两次

封装基础组件时,例如button,下面的写法应当避免:

1

2

3

onTap(e) {  if (!this.data.disabled && !this.data.loading) {    this.triggerEvent('tap', e.detail)

  }

},复制代码

1

<button></button>复制代码

这样封装出来的组件,会触发两次tap事件,一次是小程序自身触发的,一次是通过triggerEvent触发。

可以换一个非小程序内置的事件类型,比如click:

1

2

3

onTap(e) {  if (!this.data.disabled &amp;&amp; !this.data.loading) {    this.triggerEvent('click', e.detail)

  }

},复制代码

阻止tap事件冒泡也可以解决:

1

<button></button>复制代码

5. 在wxml中用Boolean()做类型转换

例如在一个组件中,监听一个String类型的参数,如果不为空则显示text标签,否则不显示:

1

// player.wxml<text>{{ leftText }}</text>复制代码

1

// index.wxml<player></player>复制代码

这种写法,leftText字段很明显已经传递了,但是依旧不显示text标签,当换一种写法后:

1

// player.wxml<text>{{ leftText }}</text>复制代码

这样就是正确的,符合我们的期望。

神奇吧?

6. InnerAudioContext调用seek方法后,onTimeUpdate回调失效

InnerAudioContext用于播放音频,给它传入onTimeUpdate回调从而获取当前的播放进度。

但是当调用seek方法跳转到指定位置播放时,onTimeUpdate就不再被调用了。

小程序社区其实很多人已经提过这个问题,大概经历了1年半的时间可微信团队迟迟没有修复,只能暂时使用折中的办法来修复,解决方案其实很简单:

1

2

3

4

5

6

7

progressOnChange(e) {  if (this.properties.src &amp;&amp; this.data.innerAudioContext) {    const innerAudioContext = this.data.innerAudioContext;

    innerAudioContext.pause();

    innerAudioContext.seek(innerAudioContext.duration * e.detail.value / 100);    setTimeout(() =&gt; {

      innerAudioContext.play();

    }, 500);

  }

},复制代码

先暂停播放,再执行seek方法,然后设置大概500ms的延时调用play方法。

7. InnerAudioContext获取duration的时机问题

本想在音频播放前拿到duration应该是实现不了了,网上关于调用onPlay、onCanplay的说法都不太靠谱,其中一个方案是这样的:

1

2

3

4

innerAudioContext.onCanplay(() =&gt; {  setTimeout(() =&gt; {    this.setData({      durationStr: secondToTimeStr(innerAudioContext.duration) || '--:--',

    });

  }, 500);

});复制代码

且不说setTimeout设置多少毫秒合适,真机上是无效的。

因此还是老老实实的用onTimeUpdate:

1

2

3

innerAudioContext.onTimeUpdate(() =&gt; {  this.setData({    durationStr: secondToTimeStr(innerAudioContext.duration) || '--:--'

  })

});复制代码

如果说觉得每次onTimeUpdate都要计算一次很耗性能的话,可以自行实现只计算一次。

8. 设置页面背景色

当前页面的json文件中有个backgroundColor字段,但是设置后无效,后面发现这个字段表示的不是可见区域的背景色,而是页面下拉时窗口的背景色。

image.png

如果需要设置页面背景色,可以通过page标签的样式设置:

1

2

page{  background: #f9fafb;

}复制代码

待更新...


版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:电脑关机状态下微信是否会自动下线的相关探讨
下一篇:全网范围内小程序接口请求封装的实例详细介绍
相关文章

 发表评论

暂时没有评论,来抢沙发吧~