在微信小程序中经常会使用到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也会抢占前台页面的执行。