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>
相关推荐
智能运维指南3 分钟前
研制过程“两张皮“怎么破:研制一体化支撑平台的定位、能力边界与落地前提
java·前端·人工智能·嘉为蓝鲸
白山编程大哥2 小时前
Java 后端如何优雅地把 List 集合返回给前端
java·前端·list
Flynt3 小时前
我把热榜那篇"禁用 axios"逐条实测了一遍:结论大体对,坑在它没讲的地方
前端·javascript·axios
Csvn3 小时前
bundle优化
前端
slongzhang_4 小时前
linux 递归删除源码文件|递归删除目录下 *.js,但排除 *.min.js
linux·开发语言·javascript
北冥有鱼4 小时前
发版后动态路由点击报 `Failed to fetch dynamically imported module`」问题上的完整排查与修复过程
前端·vue.js
静默回滚4 小时前
视频压到 25 MB 以内,码率要算、音轨要扣、余量要留
前端
用户37203749260184 小时前
把 10MB 中文语义模型塞进浏览器:STSB 做到教师模型的 93%,但线上 top1 只有 42%
前端
光锥智能4 小时前
海康机器人举行2026移动机器人新品发布会:箱式存拣升级,「明智」系列发布
java·前端·机器人
计算机魔术师4 小时前
Anthropic 上市文件最吓人的一幕,不是亏损 807 亿
前端