v-for渲染的元素上使用ref

在 Vue 3 中,如果你在一个通过 v-for 渲染的元素或组件上直接使用 ref,Vue 会自动将它们收集成一个数组形式的 ref,而不是单个实例。

示例代码:

html 复制代码
<template>
  <div v-for="item in list" :key="item.id" ref="rows">
    {{ item.name }}
  </div>
</template>

<script setup>
import { ref, onMounted } from 'vue'

const list = ref([
  { id: 1, name: '张三' },
  { id: 2, name: '李四' },
  { id: 3, name: '王五' }
])

const rows = ref([])

onMounted(() => {
  console.log(rows.value) 
  // => [HTMLDivElement, HTMLDivElement, HTMLDivElement]
})
</script>

这段代码在 Vue 3 中虽然看似没问题,但存在内存泄漏风险 ------因为直接使用 ref="rows" 在 v-for 内时,Vue 不会在卸载或列表项变化时自动清空旧引用。

进阶写法:

html 复制代码
<template>
  <div
    v-for="item in list"
    :key="item.id"
    :ref="el => setRowRef(el, item.id)"
  >
    {{ item.name }}
  </div>
</template>

<script setup>
import { reactive, nextTick, onBeforeUnmount } from 'vue'

const list = ref([
  { id: 1, name: '张三' },
  { id: 2, name: '李四' },
  { id: 3, name: '王五' }
])

// 用对象代替数组存储 refs,按 id 映射更稳定
const rowRefs = reactive({})

function setRowRef(el, id) {
  if (el) {
    rowRefs[id] = el
  } else {
    // Vue 在节点卸载时会传入 null,这里主动清理引用
    delete rowRefs[id]
  }
}

// 可选:组件卸载时彻底清空引用,防止残留
onBeforeUnmount(() => {
  for (const key in rowRefs) delete rowRefs[key]
})
</script>
相关推荐
芭拉拉小魔仙6 小时前
前端文件下载与错误处理实战指南
前端
Yao8067 小时前
MinIO自建对象存储,省OSS费用的完整方案
前端·后端
2501_933923257 小时前
设计网页的时候加载不出来怎么办?认识常见的状态码
前端·spring
only-lucky7 小时前
QML深入学习五(Controls模块)
前端·javascript·学习
程序员黑豆7 小时前
鸿蒙应用开发之路由:Router 页面路由使用教程
前端·harmonyos
gyx_这个杀手不太冷静7 小时前
Agent开发进阶指南(第 2 章):Agent 运行全流程拆解、上下文窗口、流式输出、记忆系统与 Function Call 实战
前端·架构·agent
anyup7 小时前
像这种问题千万别自己动手,否则你可太看不起 AI 了
前端·架构·trae
hunterandroid8 小时前
[鸿蒙从零到一] HarmonyOS Web 组件与 JSBridge 通信实战:从页面加载到安全协议
前端
xingren8 小时前
「拍摄器」UI 特效 - 在 Winform/WPF/WinUI3/Avalonia/Web 的实现
前端
其美杰布-富贵-李8 小时前
第 5 篇:Object3D、Group 与场景树
javascript·three.js