微信小程序:setData方法详解和注意事项

2020-08-04 15:57:28 浏览数 (1)

在微信小程序中经常会使用到setData函数把变量渲染到视图层,那么什么是setData呢?如何使用?注意事项有些什么?下面我们就来详细了解一下!

1 setData()方法

  • setData是小程序开发中使用最频繁的接口,也是最容易引发性能问题的接口。
  • setData函数用于将数据从逻辑层渲染到视图层(异步),同时改变对应的this.data的值(同步)。

1、参数接受一个对象,以key,value的形式表示;

2、参数和变量名称一致,可用一个值代替

如上图所示,在this.data中设置ceshi这条数据,在方法中,我们定义ceshi变量让其等于that.data.ceshi; 然后对ceshi进行操作,其实就是对that.data.ceshi进行操作,而that.setData({ceshi})就等同于that.setData({ceshi : ceshi }) ; 第一个ceshi 是that.data.ceshi, 第二个ceshi 是我们定义的变量ceshi。通过打印的结果可以看到,数据已经添加上了。

3、可以设置一个或多个data数据

4、key可以以数据路径的形式给出

5、key值可以为变量,为变量的时候要用[ ]引起来

如图所示 deletedtodo为变量作为key值的时候要用[ ] 包裹起来。

6、直接修改this.data,虽然会改变数据,但是页面不会重新渲染,无法改变页面状态,会造成数据不一致的情况

7、单次设置的数据不能超过1024KB,请尽量避免一次设置过多的数据

8、不需要在this.data中预先定义,使用setData()方法会自动创建该数据

name在this.data中未定义,但是这种写法不会报错,而且还会在this.data.zhong创建name这条数据。可以用this.data.name获取到该条数据。

2 json操作和数组操作一样

1、数组的增加:

我们可以自己组装一个对象如上图的obj,然后用push()方法将其添加到数据的最后。注意push的数据的index是 1的,也就是说原本数组中index依次为0,1,2,新增加的就是3,依次类推。如果想将数据插入到数据某个位置,那么可以合理运用concat()的方法将数据合并到数据中。

也可以用splice()方法添加,第一个参数是插入的位置,第二个参数设为0,则为添加,若为大于0的的数字则为要删除的个数,第三个参数只有在第二个参数为0是使用,是添加的内容。这种方法非常灵活,只需要改变第一个参数就可以将内容添加到数据的任何一个地方。下面附上splice的用法;

Splice

  • splice()方法向/从数组中添加/删除元素,然后返回被删除的元素组成的数组。
  • 用于数组对象。
  • arr.splice(index, howmany, item1,…, itemX)

参数

描述

index

必需。整数,规定了添加/删除元素的位置,使用负数可从数组结尾处规定位置。

howmany

必需。要删除的元素的数量。如果设置为0,则不会删除元素。如果添加元素则这里应该设置为0.

itemX

可选。向数组添加的新项目。在添加的时候用。

  • 注意:这个方法会对原数组做出修改。获得的也是新数组。

2、数组的删除:

删除也是用splice()方法实现的,ceshi.splice(1,1)就是从index为1的位置开始,删除1个元素。splice()用法参上。

3、数组的修改:

将key值以数据路径的形式赋值,可以达到修改数据中的某一条,此处,我们只将ceshi[0].value的值改变为'oooo',其他数据未发生变化。

也可以用这种方法修改数组的参数,对这种方法有疑问的可以参考setData()第二条。

3 实例解析和注意事项

实例1:简单实现点击修改变量值

效果:

实例解析:

  • 代码很容易理解,点击按钮test变量的值被改变了,通过setData函数渲染到了前端展示。
  • 另外我在this.setDta前后分别打印出了this.data.test的值,看看最终打印结果:

这里就说明了setData函数渲染到视图层后,会同步修改this.data.test的值。

实例2:动态修改数组指定下标的某个参数值

效果

实例解析:

  • 其实这个就是根据index找到test对应索引中对应要修改的参数,然后进行修改并渲染到页面上;
  • 该功能购物车选中状态、数量更改都可以使用到;
  • 此方法比使用循环寻找更改然后再渲染,更方便、性能更好!

注意事项

  • 如果Page对象的data中没有定义该key,则setData自动创建;如有则修改data中原变量的值。
  • 直接修改this.data,而不调用this.setData(),是无法改变当前页面的状态的,会导致数据不一致。
  • 使用this.setData({})时,注意this指向问题。仅支持可以JSON化的数据。
  • 单次设置的数据不能超过1024KB,尽量避免一次设置过多的数据。
  • 不要把data中的任何一项的value设为undefined,否则这一项将不能被设置,可能会有潜在的问题。

4 常见的setData操作错误(官方文档)

1.频繁的去setData

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

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

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

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

3.后台态页面进行setData

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

0 人点赞