网络日志

vue 设置动态 ref

最近使用el-tabs组件遇到了一个问题:就是el-tabs中el-tab-pane是动态生成的,而且后续需要获取el-tab-pane中元素的ref,代码大概是下面的样子:
<el-tabs
  v-model="activeName"
  type="card"
  @tab-click="handleClick"
>
  <el-tab-pane v-for="(item, index) in case_tabs" :label="item.name" :name="index.toString()" :key="index">
    <TabList :ref="`tab${index}`"/>
  </el-tab-pane>
</el-tabs>

这个使用场景是当切换tab时,要调用组件<TabList />内部的的load方法。

handleClick(tab) {
  this.activeName = tab.index
  this.$refs[`tab${tab.index}`].load()
}

看似没有毛病,但是点击切换时就报错了,提示this.$refs[tab${tab.index}]是undefined。

这时就需要去搞明白这个ref到底是什么样的工作机制,vue官网查到以下内容:

ref 被用来给元素或子组件注册引用信息。引用信息将会注册在父组件的 $refs 对象上。如果在普通的 DOM 元素上使用,引用指向的就是 DOM 元素;如果用在子组件上,引用就指向组件实例

当 v-for 用于元素或组件的时候,引用信息将是包含 DOM 节点或组件实例的数组。

关于 ref 注册时间的重要说明:因为 ref 本身是作为渲染结果被创建的,在初始渲染的时候你不能访问它们 - 它们还不存在!$refs 也不是响应式的,因此你不应该试图用它在模板中做数据绑定。

可见,我们在使用v-for时应该把子组件的ref存放在一个数组中。

解决方案

<template>
  <el-tabs
    v-model="activeName"
    type="card"
    @tab-click="handleClick"
  >
    <el-tab-pane v-for="(item, index) in case_tabs" :label="item.name" :name="index.toString()" :key="index">
      <TabList :ref="setItemRef"/>
    </el-tab-pane>
  </el-tabs>
<template>

<script>
export default {
  name: "CaseList",
  ...,
  data(){
    return {
        refList: []
    }
  }
  methods: {
    setItemRef(el) {
      this.refList.push(el)
    },
    handleClick(tab) {
      this.activeName = tab.index
      this.refList[tab.index].load()
    },
  }
}
</script>

这样程序就可以正常工作了。

文章首发于我的个人博客 《IICOOM-vue 设置动态 ref》