Vue 3 中动态赋值 ref 的应用

引言

Vue 3 引入了许多新特性，其中之一便是 Composition API。Composition API 提供了一种新的编程范式，使开发者能够更灵活地组织和复用逻辑。其中 ref 是一个核心概念，它允许我们在组件内部声明响应式的状态。本文将探讨如何在 Vue 3 中使用 ref 进行动态赋值，并通过一个具体的例子来说明这一过程。

什么是 ref

在 Vue 3 中，ref 是一个函数，它接受一个值作为参数，并返回一个带有 .value 属性的对象。这个对象的 .value 属性是响应式的，这意味着任何对 .value 的更改都会触发依赖此数据的视图重新渲染。这对于管理组件内的状态非常有用。

动态赋值 ref 的场景

在某些情况下，我们需要在运行时动态地给 ref 赋值，尤其是在处理 DOM 元素时。例如，当我们需要初始化一个图表，并且图表容器是由一个 DOM 元素提供的，这时候就需要在 DOM 渲染完毕后，获取到这个元素，并将其赋值给 ref，以便后续操作。

实现示例

让我们通过一个简单的 Vue 3 组件来演示如何动态赋值 ref。假设我们要创建一个包含一个图表的组件，并且需要在图表初始化时传递一个 DOM 元素作为图表的容器。

1. 创建 Vue 3 组件

首先，我们需要创建一个 Vue 3 组件，并在其中定义一个 ref 来存储我们的图表容器。

<template>
  <div :ref="setChartRef" style="width: 100%; height: 350px"></div>
</template>

<script setup>
import { ref } from 'vue';

const chartRef = ref(null); // 初始化为空

// 动态赋值函数
const setChartRef = (e) => {
  chartRef.value = e;
};
</script>

2. 初始化图表

接下来，我们需要在组件挂载完成后初始化图表，并使用 chartRef 获取到图表容器。

<script setup>
import { ref, onMounted } from 'vue';
import * as echarts from 'echarts';

const chartRef = ref(null); // 初始化为空

// 动态赋值函数
const setChartRef = (e) => {
  chartRef.value = e;
};

// 组件挂载完成后的生命周期钩子
onMounted(() => {
  if (chartInstance.value) {
    // 销毁已存在的图表实例
    chartInstance.value.dispose();
  }

  const chartInstance = echarts.init(chartRef.value);
  chartInstance.setOption({
    title: { text: '动态赋值 ref 示例' },
    tooltip: {},
    xAxis: {
      data: ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"]
    },
    yAxis: {},
    series: [{
      name: '销量',
      type: 'bar',
      data: [5, 20, 36, 10, 10, 20]
    }]
  });

  // 保存图表实例
  chartInstance.value = chartInstance;
});
</script>

在这个示例中，我们使用了 Vue 3 的 onMounted 生命周期钩子，在组件挂载完成后初始化图表。chartInstance 用于存储图表实例，以便我们可以在需要的时候访问它。

3. 总结

通过以上示例，我们展示了如何在 Vue 3 中使用 ref 来动态赋值，并利用这一特性来初始化一个图表。这种方法不仅提高了代码的可维护性，还使得状态管理变得更加清晰和直观。

动态赋值 ref 的应用场景非常广泛，除了图表初始化之外，还可以用于处理用户输入、DOM 操作等。