最近在做一个需求,当用户放大地图到某个级别时,自动显示marker
的callout标签,当小于这个缩放级别时,则隐藏callout。然而在我实现的过程中,却发现一个严重的问题:当我操作marker数据时,会导致地图的缩放级别发生变化(用户没有缩放的操作)。这TM是什么鬼??接下来就开始爬坑。
官方的避坑指南
在mpvue的文档中,官方是给出一些避坑指南的:
列表中没有的原生事件也可以使用例如 bindregionchange 事件直接在 dom 上将bind改为@,同时这个事件也非常特殊,它的 event type 有 begin 和 end 两个,导致我们无法在handleProxy 中区分到底是什么事件,所以你在监听此类事件的时候同时监听事件名和事件类型既 <map @regionchange="functionName" @end="functionName" @begin="functionName"><map>
如果你发现@regionchange
没有触发,十有八九是掉到这个坑里面了。
map组件类似一个特殊的表单元素
然而上面的指南跟我遇到的问题没什么关系,我们还是要继续分析。map组件的操作很多,比如拖动,缩放,点击等。当用户进行拖动和缩放操作时,都会触发regionchange
事件,如果我们绑定了scale
,latitude
或者longitude
属性,像下面这样:
<map
id="map"
:markers="markers"
:scale="scale"
:latitude="latitude"
:longitude="longitude"
@callouttap="goToClass"
@end="regionchange"
@begin="regionchange"
@regionchange="regionchange"
show-location
style="width: 100%; height: 100vh">
1.当我们绑定了这些属性(scale,latitude,longitude)等,2.用户进行了缩放操作,3.再去进行数据操作,就会出现上述bug。
将上诉三个条件合起来分析可以得出,这是由于mpvue和小程序的数据没有保持一致引起的。当用户进行了缩放和移动操作时,其实scale数据已经更新,然而vm中的数据并没有相应的更新,在再次进行数据操作时,会导致旧的scale数据覆盖小程序的scale,发生改动的是marker数据,缩放级别也被更新了的bug。
所以在用户缩放操作时,需要监听相应事件,手动更新vm中的相应的数据,来维持vm和小程序中的数据同步。不然会造成mpvue实例的数据和小程序的实际缩放数据不一致。换句话说,map组件可以类比<input>
元素,在input元素中,通过:value
来设置数据,通过@input
来更新vm的数据,从而保证vm中的数据和DOM中元素数据的一致性。所以在map中也一样,也要在regionchange中更新vm的数据来保证数据的一致性:
methods: {
regionchange: (e) => {
this.ctx.getScale({// this.ctx是MapContext对象的引用 https://developers.weixin.qq.com/miniprogram/dev/api/map/MapContext.html
success: (res) => {
this.scale = res.scale
}
})
this.ctx.getCenterLocation({
success: (res) => {
this.latitude = res.latitude
this.longitude = res.longitude
}
})
}
}
通过上面的代码,保证了vm数据和小程序的数据同步,避免了操作marker数据时,将旧的longitude,scale,latitude数据传给小程序,造成在用户没有缩放操作的情况下地图被缩放。问题是解决了,但是为什么我改变的是markers的数据,mpvue会将longitude这个数据也一起传给小程序呢,咱们继续
mpvue的setData设计
Taro 1.0发布时,提到了小程序 setState 性能优化:
在 setData 之前进行了一次数据 Diff,找到数据的最小更新路径,然后再使用此路径来进行更新
这个其实也是mpvue的一大痛点,我们来看一下mpvue的相关源码:
export function updateDataToMP () {
const page = getPage(this)
if (!page) {
return
}
const data = formatVmData(this)
throttleSetData(page.setData.bind(page), data)
}
上面的代码中,通过page.setData
,更新vm的data数据,并用throttleSetData
进行50ms一次的节流。然而,第二个参数data依然是将vm中的全部数据传给setData,而没有检测究竟data中的哪些字段真正发生了变化。
综合起来讲,vm和小程序数据没有保持统一,和mpvue setData前没有diff一次找出真正需要更新的数据,这两个因素共同造成了上面的bug。
另一种解决办法
在实践中发现,双向绑定虽然不会造成地图缩放级别重置,但是依然会造成抖动,所以另一种解决办法是不再对scale,latitude,longitude
这3个参数进行响应式绑定,改为使用原生小程序的api来操作。代码如下:
this.$mp.page.setData({
'$root[0].latitude': data[0].latitude,
'$root[0].longitude': data[0].longitude,
'$root[0].scale': INIT_SCALE
})
通过this.$mp.page来拿到小程序的page实例,自己在需要的时候手动进行setData。需要注意的地方时在模板中依然需要绑定,保证编译出来的wxml知道这里是可以setData的,但是在data中没有相关的值,从而使scale这些数据不是响应式的
<map
id="map"
:scale="scale"
:latitude="latitude"
:longitude="longitude">
//在js中
<script>
export default{
data(){
return {
这里不写 scale,latitude,longitude这些属性
}
}
}
</script>
(完)