必知小技巧:微信小程序this.setData修改对象中某个属性的值

本文介绍了微信小程序中使用this.setData方法修改对象属性值的方法,包括在外层使用数组包裹键值对及放置于对象内部的不同方式,并展示了如何更新数组中特定对象的属性。

前言

关于“微信小程序 this.setData 修改对象中某个属性的值”,这是一个非常常见且有用的操作。在本文中,我将模拟各种使用场景介绍如何使用 this.setData 方法来实现相关的操作。从而帮助大家更好地了解和掌握这一技巧。


常规写法

做过微信小程序的同学都知道,this.setData() 方法可以修改或者更新 data 中的值 。那不知道大家有没有遇到这么一种情况,我要修改对象中某个属性的值该怎么办呢?是不是第一想到的就是这样写:

在这里插入图片描述

结果是在编译器中就直接报错,很显然,肯定是不能这样写的,那如果我就是想要修改对象中某个属性的值呢?


一、在其外面套一层数组

['对象.属性']: 修改的值

.wxml

<view>
    <view class="tabsBox">
        <text>性别:</text>
        <text>{{objs.sex}}</text>
    </view>
    <view class="tabsBox">
        <text>年龄:</text>
        <text>{{objs.age}}</text>
    </view>
    <button bindtap="btnClick">点击修改</button>
</view>

.js

const app = getApp()
Page({
    data: {
        // 默认的数据
        objs: {
            sex: "女",
            age: "18",
        },
    },
    // 点击事件
    btnClick() {
        this.setData({
            ['objs.sex']: "男",
            ['objs.age']: "20",
        })
    },
})

实现效果

在这里插入图片描述


二、放在对象中

对象: {属性: '值'}

.wxml

<view>
    <view class="tabsBox">
        <text>性别:</text>
        <text>{{objs.sex}}</text>
    </view>
    <view class="tabsBox">
        <text>年龄:</text>
        <text>{{objs.age}}</text>
    </view>
    <button bindtap="btnClick">点击修改</button>
</view>

.js

const app = getApp()
Page({
    data: {
        // 默认的数据
        objs: {
            sex: "女",
            age: "18",
        },
    },
    // 点击事件
    btnClick() {
        this.setData({
            objs: {
                sex: "男",
            },
        })
    },
})

实现效果

在这里插入图片描述

可以看到一个很明显的问题,我明明只修改了性别字段的值,但是默认存在的年龄字段的值却消失了,因为这种写法会导致该对象的其他属性全部消失,所以要慎重选择,尽量使用第一种写法就好啦。


.wxss文件

.tabsBox {
    margin: 0rpx 10rpx;
    padding: 20rpx 0rpx;
    font-size: 30rpx;
    border-bottom: 1px solid gainsboro;
}

- 拓展延伸

修改数组中某个对象的属性值

.wxml

<view>
    <view wx:for="{{imgData}}" wx:key="index">
        <view>{{item.imgTit}}</view>
        <view>
            <image src="{{item.imgUrl}}"></image>
        </view>
    </view>
    <button bindtap="btnClick">点击修改</button>
</view>

.js

const app = getApp()
Page({
    data: {
        // 默认的数据
        imgData: [{
            imgTit: "风景图1",
            imgUrl: "https://img0.baidu.com/it/u=530426417,2082848644&fm=253&app=138&size=w931&n=0&f=JPEG&fmt=auto?sec=1656522000&t=0050fe01b5db9476166821b30d44655c",
        }, {
            imgTit: "风景图2",
            imgUrl: "https://img1.baidu.com/it/u=700675537,3936578503&fm=253&app=138&size=w931&n=0&f=JPEG&fmt=auto?sec=1656522000&t=54182c0a2d3f1d8d22d9c24e8556a12e",
        }],
    },
    // 点击事件
    btnClick() {
        //数组动态赋值
        const imgOne = "imgData[0].imgUrl";
        const imgTwo = "imgData[1].imgUrl";
        this.setData({
            [imgOne]: "https://img0.baidu.com/it/u=3643895624,2552772604&fm=253&fmt=auto&app=120&f=JPEG?w=1200&h=675",
            [imgTwo]: "https://img2.baidu.com/it/u=63249423,2260265143&fm=253&fmt=auto&app=120&f=JPEG?w=889&h=500",
        })
    },
})

如下:
在这里插入图片描述

<think> 我们遇到的问题是在微信小程序的 `getUserProfile` 接口的成功回调函数中,使用 `this.setData` 时出现错误:`TypeError: _this.setData is not a function`。根据提供的引用内容,这个错误通常是由于在回调函数中 `this` 的指向发生了变化,导致 `this` 不再指向页面实例。 在微信小程序中,`this` 在回调函数(如 `success`、`fail`、`complete`)中通常指向的是回调函数本身的上下文,而不是页面实例。因此,如果我们直接在回调函数中使用 `this.setData`,会因为 `this` 没有 `setData` 方法而报错。 引用[1]和[2]提供了解决方法:在进入外层函数时,将 `this` 赋给一个局部变量(通常命名为 `that` 或 `self`),然后在回调函数中使用这个局部变量来调用 `setData` 方法。 具体到我们的场景,就是在调用 `wx.getUserProfile` 之前,将 `this` 保存到一个变量(比如 `that`)中,然后在 `success` 回调函数中使用 `that.setData`。 示例代码: ```javascript // 在Page的某个方法中调用getUserProfile onGetUserProfile: function() { // 保存当前页面实例的this var that = this; wx.getUserProfile({ desc: '获取用户信息', success: function(res) { // 这里使用that,因为that指向的是外层的页面实例 that.setData({ userInfo: res.userInfo }); }, fail: function(err) { console.error(err); } }); } ``` 注意:如果使用了箭头函数,箭头函数不会改变 `this` 的指向,所以可以直接使用 `this`。但是微信小程序的API回调函数不支持箭头函数(因为它是普通函数,不是箭头函数),所以我们不能直接改变回调函数的定义方式。但是,我们可以将回调函数写成箭头函数的形式(如果我们的开发环境支持ES6并且编译后能正确运行)。 但是,在微信小程序的开发环境中,我们通常使用ES5的写法,所以推荐使用 `that` 的方式。 另外,引用[3]和[4]也提到了同样的问题,即在 `wx.request` 的回调函数中也会出现,解决方法相同。 所以,针对 `getUserProfile` 的成功回调中出现的 `_this.setData is not a function` 错误,我们可以通过保存 `this` 的引用来解决。 如果问题仍然存在,请检查保存 `this` 的变量(`that`)是否在回调函数的作用域内,以及是否正确地指向了页面实例。 下面是一个完整的示例: ```javascript Page({ data: { userInfo: null }, onLoad: function() { // 页面初始化 }, // 按钮点击事件处理函数 onGetUserInfo: function() { var that = this; // 保存this wx.getUserProfile({ desc: '用于完善会员资料', // 声明获取用户个人信息后的用途,不超过30个字符 success: function(res) { // 成功回调 that.setData({ userInfo: res.userInfo }); }, fail: function(err) { console.error('获取用户信息失败', err); } }); } }); ``` 这样,在成功回调中,我们使用的是 `that.setData`,而 `that` 指向的是页面实例,因此就不会再报错了。 如果还有疑问,请确认代码中是否在回调函数之前正确声明了 `that` 并且赋了 `this`。 另外,如果使用了ES6的箭头函数,可以这样写(注意:微信小程序基础库2.3.0以上支持): ```javascript wx.getUserProfile({ desc: '用于完善会员资料', success: (res) => { // 箭头函数不会改变this的指向,所以这里的this还是指向页面实例 this.setData({ userInfo: res.userInfo }); }, fail: (err) => { console.error('获取用户信息失败', err); } }); ``` 使用箭头函数可以避免保存 `that` 的步骤,但要注意箭头函数的兼容性。 综上所述,解决 `TypeError: at getUserProfile success _this.setData is not a function` 的方法有两种: 1. 使用临时变量(如 `that`)保存 `this`,然后在回调函数中使用该变量。 2. 使用箭头函数(注意基础库版本要求)。 推荐第一种方法,因为兼容性更好。 如果问题仍未解决,请检查是否有其他因素干扰(如异步操作等)。 </think> ### 解决 `TypeError: at getUserProfile success _this.setData is not a function` 错误 此错误发生在微信小程序调用 `getUserProfile` 接口时,其 `success` 回调函数中 `this.setData` 指向失效。核心原因是 **回调函数的 `this` 作用域丢失**,导致无法访问页面实例的方法。以下是详细解决方案: --- ### 解决方法(三种方案任选其一) #### 方案 1:使用临时变量保存 `this`(推荐) ```javascript getUserProfile() { // 关键:在第一层函数保存 this const that = this wx.getUserProfile({ desc: "获取用户信息", success(res) { // 使用 that 替代 this that.setData({ userInfo: res.userInfo, hasUserInfo: true }) }, fail(err) { console.error("获取失败", err) } }) } ``` **原理**: 在函数第一层声明 `that = this` 保存页面实例,回调函数通过闭包访问 `that`(引用[1][^1], [2][^2])。 --- #### 方案 2:使用箭头函数(ES6) ```javascript getUserProfile() { wx.getUserProfile({ desc: "获取用户信息", // 箭头函数继承外层 this success: (res) => { this.setData({ userInfo: res.userInfo }) } }) } ``` **原理**: 箭头函数没有自己的 `this`,直接继承外层作用域的 `this` (无需额外变量)[^3]。 --- #### 方案 3:使用 `bind` 绑定作用域 ```javascript getUserProfile() { wx.getUserProfile({ desc: "获取用户信息", success: function(res) { this.setData({ userInfo: res.userInfo }) }.bind(this) // 显式绑定 this }) } ``` **原理**: 通过 `bind(this)` 强制将回调函数的 `this` 绑定到页面实例[^4]。 --- ### 错误重现示例(需避免) ```javascript // ❌ 错误写法:回调内 this 指向错误 getUserProfile() { wx.getUserProfile({ success(res) { // 此时 this 指向 success 函数的上下文 this.setData(...) // TypeError: _this.setData is not a function } }) } ``` --- ### 关键注意事项 1. **作用域层级** `that=this` 须在第一层函数声明,若写在嵌套函数内部仍会失效(引用[2][^2]): ```javascript // ❌ 错误:that 声明在第二层 getData() { wx.request({ success() { var that = this // 无效! that.setData(...) // 仍报错 } }) } ``` 2. **异步回调通用规则** 所有微信小程序异步 API(`wx.request`、`wx.login` 等)的回调函数都可能存在此问题,需统一处理作用域。 3. **真机调试** 部分 IDE 模拟器不会报错,但真机现,务用真机测试。 --- ### 调试技巧 ```javascript success(res) { console.log(this) // 打印 this 验证指向 // 若输出非页面实例(如 Object{...}),说明作用域错误 } ``` > 通过上述方案可彻底解决作用域丢失问题。方案 1 兼容性最佳,方案 2 代码最简洁,推荐根据项目 ECMAScript 版本选择[^1][^2][^3][^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

水星记_

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值