shallowRef 创建仅对 .value 本身响应的引用,修改其嵌套属性不触发更新,需用 triggerRef 手动通知依赖重新求值;它只作用于 shallowRef,用于保留引用且避免深度响应开销的场景。

在 Vue 3 中,shallowRef 用于创建一个只对 .value 本身做响应式、不递归代理内部属性的引用。但这也带来一个问题:当你修改 shallowRef.value 的某个嵌套属性时(比如 shallowRef.value.name = 'Alice'),视图不会自动更新——因为响应式系统根本没追踪到这个变化。
triggerRef:手动通知视图重新渲染
triggerRef() 是专门为此设计的工具函数。它会强制触发依赖该 shallowRef 的所有副作用(如组件渲染、watchEffect 等),相当于“告诉 Vue:这个 shallowRef 虽然没变,但它内部内容变了,请重新读取并更新。”
- 它只对
shallowRef有效,对普通 ref 或 reactive 对象无效 - 调用后,组件中访问该 shallowRef.value 的地方会重新求值,触发 DOM 更新
- 不需要传新值,也不改变原始值,只是“刷新依赖”
什么时候必须用 triggerRef?
典型场景是操作大型不可变数据或第三方库对象(如 Three.js 场景、Canvas 上下文、Map/Set 实例等),你希望避免深度响应式开销,又需要修改后视图同步。
- 修改 shallowRef.value 的属性但未替换整个 value(如
state.obj.count++) - 通过外部库方法修改了对象内部状态(如
chartInstance.resize()) - 使用 Object.assign 或解构赋值更新了 shallowRef.value 的部分字段
正确用法示例
✅ 推荐写法:
Vue 3 组合式 API 与
相关专题
Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。
2503
2023.08.11
实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。
5423
2023.10.09
前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。
863
2024.05.22
vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。
1674
2023.07.17
vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。
12102
2024.02.23
本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。
316
2026.02.10
Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。
20
2026.10.16
热门下载
相关下载
精品课程
最新文章

