微信小程序—setData()的使用方法和注意事项

2020-12-14 14:42:39 浏览数 (1)

在小程序中各个页面之间是相互独立的,一个页面分为渲染层(视图层 webview)、逻辑层、系统层(底层)。在架构上,WebView和JavascriptCore都是独立的模块,并不具备数据直接共享的通道。换而言之,若要将逻辑层中的data的数据渲染到页面中,他们之间是无法直接通信的,往往需要系统层作为中间角色。 我们都知道视图层的数据来源于逻辑层data,而视图图层若想要改变逻辑层data的数据,需要借助setData这个方法去触发,以达到更新视图层的数据,具体的过程是怎么样的呢?

1

setData是什么?

定义: 设置数据,更改数据 作用: setData函数用于将数据从逻辑层发送到视图层(异步),同时改变对应的this.data的值(同步)。

仔细细品这句话,会包含了很多信息

  • setData它是微信小程序提供的一个内置的接口,是用于改变逻辑层中data下的数据的。
  • 视图层 view的数据挂载在逻辑层的data下,发送到视图层中是异步的。
  • 改变this.data是同步,换句话说,若直接修改 this.data 而不调用 this.setData方法,是无法改变页面的状态的,还会造成数据不一致。

从上面的这张图中就可以看到,当逻辑层data数据渲染到界面的时候,逻辑层的数据需要经过系统层,当系统层接收到这个逻辑层的数据后,系统层在把数据转发给渲染层,然后在渲染层展示出来,在这个过程当中是异步的。

视图层和逻辑层的数据传输,实际上通过两边提供的JavScript Core所实现,即用户传输的数据,需要将其转换为字符串形式传递,同时把转换后的数据内容拼接成一份 JS 脚本,再通过执行 JS 脚本的形式传递到两边独立的环境。

2

setData()方法的使用

setData 函数用于将数据从逻辑层发送到视图层(异步),同时改变对应的 this.data 的值(同步)。

参数说明:

Object 以 key: value 的形式表示,将 this.data 中的 key 对应的值改变成 value。

其中 key 可以以数据路径的形式给出,支持改变数组中的某一项或对象的某个属性,如 array[2].message,a.b.c.d,并且不需要在 this.data 中预先定义。

注意:

  1. 直接修改this.data,而不调用this.setData(),是无法改变当前页面的状态的,会导致数据不一致
  2. 仅支持可以JSON化的数据
  3. 单次设置的数据不能超过1024KB,尽量避免一次设置过多的数据
  4. 不要把data中的任何一项的value设为undefined,否则这一项将不能被设置,可能会有潜在的问题

使用:先给出代码,wxss没有什么意义就不贴了。一般会用到小程序中封装好的setdata方法:

/** `setData` 函数用于将数据从逻辑层发送到视图层 *(异步),同时改变对应的 `this.data` 的值(同步)。 * * **注意:** * * 1. **直接修改 this.data 而不调用 this.setData 是无法改变页面的状态的,还会造成数据不一致**。 * 1. 仅支持设置可 JSON 化的数据。 * 1. 单次设置的数据不能超过1024kB,请尽量避免一次设置过多的数据。 * 1. 请不要把 data 中任何一项的 value 设为 `undefined` ,否则这一项将不被设置并可能遗留一些潜在问题。 */ setData( /** 这次要改变的数据 * * 以 `key: value` 的形式表示,将 `this.data` 中的 `key` 对应的值改变成 `value`。 * * 其中 `key` 可以以数据路径的形式给出,支持改变数组中的某一项或对象的某个属性,如 `array[2].message`,`a.b.c.d`,并且不需要在 this.data 中预先定义。 */ data: Partial<D> & IAnyObject, /** setData引起的界面更新渲染完毕后的回调函数,最低基础库:`1.5.0` */ callback?: () => void ): void

index.wxml

1 <view class="numview">test01======={{test01}}</view> 2 <view class="numview">test02======={{test02}}</view> 3 <button bindtap="testfun">测试</button>

index.js

1 Page({ 2 data: { 3 test01: 1, 4 test02: 2 5 }, 6 testfun: function() { 7 var that = this; 8 if (this.data.test01 == 1) { 9 that.setData({ 10 test02:8 11 }) 12 console.log(this.data.test02) 13 } 14 }, 15 onLoad: function() {}, 16 })

此时经过编译后模拟器的显示:

这里都容易理解,当点击了button按钮后,触发点击事件执行testfun函数,将test02设置为8,如图:

通过this.data.test02=8这种方式直接赋值可以吗,答案是不可以,看下面:

使用this.data.test02=10的结果不会渲染到前台页面中显示,但是后台已经改变,会造成前后台数据不一致

我又想到是不是可以先通过this.data.test02=10赋值,再通过this.setData渲染呢?

1 onLoad: function() { 2 this.data.test02 = 10; 3 this.setData({ 4 test02 5 }) 6 }

编译报错:test02 is not defined;

为什么呢?再进行一项测试:

1 onLoad: function() { 2 this.data.test02 = 10; 4 this.setData({ 5 test03: 20 6 }) 7 console.log(this.data.test03) 8 } 复制代码

编译后显示:

发现了什么?我个人觉得是这样的:

  • this.setData中设置的key和value,如果在data中已有定义,则修改data中原变量的值,直接渲染到前台并修改原data中的数据;
  • 如果data中没有定义该key,则setData自动创建,这个可以从打印结果中发现(this.data.test03,data中没有定义);
  • 不能直接使用this.data.属性赋值,
  • setData需要设置key和value

3

setData()注意事项

1、频繁的去setData

在我们分析过的一些案例里,部分小程序会非常频繁(毫秒级)的去setData,其导致了两个后果:

  • Android下用户在滑动时会感觉到卡顿,操作反馈延迟严重,因为JS线程一直在编译执行渲染,未能及时将用户操作事件传递到逻辑层,逻辑层亦无法及时将操作处理结果及时传递到视图层;
  • 渲染有出现延时,由于WebView的JS线程一直处于忙碌状态,逻辑层到页面层的通信耗时上升,视图层收到的数据消息时距离发出时间已经过去了几百毫秒,渲染的结果并不实时;

2、每次setData都传递大量新数据

由setData的底层实现可知,我们的数据传输实际是一次evaluateJavascript脚本过程,当数据量过大时会增加脚本的编译执行时间,占用WebView JS线程。

3、后台态页面进行setData

当页面进入后台态(用户不可见),不应该继续去进行setData,后台态页面的渲染用户是无法感受的,另外后台态页面去setData也会抢占前台页面的执行。

结语

在本文中主要介绍了下setData的使用,它是用于修改挂载在data下面的数据的,当想要修改视图view,那么需要借助setData函数,它接收两个参数,第一个参数时必传的,也就是要修改视图view层的对象,而第二个参数时非必传的。 setData将数据从逻辑层发送到视图层是异步,同时改变对应的this.data的值是同步,它并不是实时的,这也导致了必须要考虑性能的因素。从而介绍了setData的使用注意事项,值得注意的是,如何修改对象下的某个属性,这个在往后的开发中,是使用比较频繁的。 如果小伙伴们有问题,欢迎大家下面留言,一起学习讨论~

0 人点赞