微信小程序之this.setData

最新推荐文章于 2025-11-12 15:00:27 发布

原创最新推荐文章于 2025-11-12 15:00:27 发布 · 3.2w 阅读

8 ·

CC 4.0 BY-SA版权

微信小程序专栏收录该内容

3 篇文章

订阅专栏

本文介绍了Page.prototype.setData()函数的功能及使用方法。此函数用于将数据从逻辑层发送到视图层并更新this.data的值。文章强调了直接修改this.data无效，并提供了正确的setData()用法示例。

Page.prototype.setData()

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

注意：

直接修改 this.data 无效，无法改变页面的状态，还会造成数据不一致。
单次设置的数据不能超过1024kB，请尽量避免一次设置过多的数据。

setData() 参数格式

接受一个对象，以 key，value 的形式表示将 this.data 中的 key 对应的值改变成 value。

其中 key 可以非常灵活，以数据路径的形式给出，如 array[2].message，a.b.c.d，并且不需要在 this.data 中预先定义。

Page({
  data: {
    text: 'init data',
    array: [{text: 'init data'}],
    object: {
      text: 'init data'
    }
  },
  changeText: function() {
    // this.data.text = 'changed data'  // bad, it can not work
    this.setData({
      text: 'changed data'
    })
  }