淺談vue2的$refs在vue3組合式API中的替代方法

更新時(shí)間：2021年04月18日 15:21:39 作者：devpoint

這篇文章主要介紹了淺談vue2的$refs在vue3組合式API中的替代方法，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

如果你有過(guò)vue2的項(xiàng)目開發(fā)經(jīng)驗(yàn)，那么對(duì)$refs就很熟悉了。由于vue3的斷崖式的升級(jí)，在vue3中如何使用$refs呢？想必有遇到過(guò)類似的問(wèn)題，我也有一樣的疑惑。通過(guò)搜索引擎和github，基本掌握如何使用$refs。在vue3中使用組合式API的函數(shù)ref來(lái)代替靜態(tài)或者動(dòng)態(tài)html元素的應(yīng)用。

最近業(yè)余在學(xué)習(xí)vue3項(xiàng)目《蠟筆（Crayon）管理模板：Vue3 + Vuex4 + Ant Design2》開發(fā)，這兩天迭代推進(jìn)了一點(diǎn)，實(shí)現(xiàn)了chart圖表組件，寫文章的時(shí)候發(fā)現(xiàn)提交代碼的commit有錯(cuò)別字。

在vue3中使用組合式API的setup()方法的時(shí)候，無(wú)法正常使用this.$refs，但可以使用新的函數(shù)ref()。

下面代碼摘自：https://github.com/QuintionTang/crayon/blob/feat-dashboard/src/qtui/components/Chart.vue

<template>
    <canvas ref="refChart" :height="setHeight"></canvas>
</template>
<script>
import { defineComponent, onMounted, ref, inject, watch } from "vue";
import Chart from "chart.js";
import { deepCopy } from "@/helper/index";
export default defineComponent({
    name: "QtChart",
    props: {
        type: {
            type: String,
            required: true,
            default: "line",
        },
        data: {
            type: Object,
            required: true,
            default: () => ({}),
        },
        options: {
            type: Object,
            default: () => ({}),
        },
        height: {
            type: Number,
            default: 0,
        },
        refKey: {
            type: String,
            default: null,
        },
    },
    setup(props) {
        const refChart = ref();
        // 初始化方法
        const init = () => {
            const canvasChart = refChart.value?.getContext("2d");
            const chartHelper = new Chart(canvasChart, {
                type: props.type,
                data: deepCopy(props.data),
                options: props.options,
            });
            watch(props, () => {
                chartHelper.data = deepCopy(props.data);
                chartHelper.options = props.options;
                chartHelper.update();
            });
            // 附加一個(gè)實(shí)例給refChart
            refChart.value.instance = chartHelper;
        };
        // 設(shè)置高度
        const setHeight = () => {
            return {
                height: props.height,
            };
        };
        // 綁定一個(gè)實(shí)例，使用inject注入
        const bindInstance = () => {
            if (props.refKey) {
                const bind = inject(`bind[${props.refKey}]`);
                if (bind) {
                    bind(refChart.value);
                }
            }
        };
        onMounted(() => {
            bindInstance();
            init();
        });
        return {
            refChart,
            setHeight,
        };
    },
});
</script>

這段代碼完整的實(shí)現(xiàn)了一個(gè)圖表組件Chart，其中自定義了屬性props，通過(guò)把參數(shù)傳遞給setup方法來(lái)使用其屬性值。html中定義一個(gè)ref="refChart"來(lái)作為圖表的dom對(duì)象，在setup方法中通過(guò)方法ref方法來(lái)定義響應(yīng)式可變對(duì)象，并在setup函數(shù)結(jié)尾作為返回值。

const refChart = ref();

需要注意的是，返回值的屬性名必須和html中的ref值一致。

下面代碼是可以正常執(zhí)行的。

<template>
    <canvas ref="refChart" :height="setHeight"></canvas>
</template>
<script>
import { defineComponent, onMounted, ref, inject, watch } from "vue";
import Chart from "chart.js";
import { deepCopy } from "@/helper/index";
export default defineComponent({
    name: "QtChart",
    props: {
        // ... 
    },
    setup(props) {
        const refChartBox = ref();
        // ...
        return {
            refChart:refChartBox,
        };
    },
});
</script>

下面的情況，會(huì)出現(xiàn)程序錯(cuò)誤，無(wú)法達(dá)到預(yù)期效果。應(yīng)為html中定義的ref="refChart"和setup返回的refChartBox不一致。

<template>
    <canvas ref="refChart" :height="setHeight"></canvas>
</template>
<script>
import { defineComponent, onMounted, ref, inject, watch } from "vue";
import Chart from "chart.js";
import { deepCopy } from "@/helper/index";
export default defineComponent({
    name: "QtChart",
    props: {
        // ... 
    },
    setup(props) {
        const refChartBox = ref();
        // ...
        return {
            refChartBox,
        };
    },
});
</script>