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

在微信小程序中经常会使用到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)

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

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也会抢占前台页面的执行。