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>
相关推荐
Aniugel3 小时前
Vue2简单实现一个权限管理
前端·vue.js
乐无止境3 小时前
系统性整理组件传参14种方式
前端
爱泡脚的鸡腿3 小时前
uni-app D8 实战(小兔鲜)
前端·vue.js
izx8883 小时前
JavaScript 中 `this` 的真相:由调用方式决定的动态指针
javascript
睡神雾雨3 小时前
Vite 环境变量配置经验总结
前端
咪库咪库咪3 小时前
vue5
前端
前端缘梦3 小时前
JavaScript核心机制:执行栈、作用域与this指向完全解析
前端·javascript·面试
Larry_zhang双栖3 小时前
解决 Figma MCP 下载图片卡死问题:从踩坑到自研 npm 工具全记录
前端·npm·figma
JarvanMo3 小时前
Flutter 3.38 动画新特性:动画引擎有什么新变化?
前端
春卷同学3 小时前
拼图游戏 - Electron for 鸿蒙PC项目实战案例
javascript·electron·harmonyos