Vue3 关于 provide、inject 的用法

news2024/11/18 9:34:01

前言： 在前端项目中牵扯的最多的莫过于组件之间的传值了，除了最最常用的 props 和 emit，其实在 Vue 中还额外提供了另外几种方法。今天分享一种组件之间通信的方法。

一. 场景再现

先别着急考虑标题这个 api 的含义。在这里我先动手写一个比较常见的场景。
所对应的组件内部代码比较简单，这里我就不展示了，逻辑上就是这三个组件层层引用。

所对应的页面效果如下：
如上图，这是一个在项目中很常见的一个场景，三层嵌套的组件。(其实还有深层次的嵌套，目前我们拿三层嵌套举例足矣)
ok，你现在的需求是：在爷爷组件内需要提供一个字符串数据 “韩振方” 去提供给 儿子组件使用。
聪明的你肯定想到了 props，废话不多说，我们直接上手。

二. 传递 Props

“我以为多高深呢，这不就是数据父传子的场景吗？我直接传递 props 去完成这个需求。”
于是我会在 GrandFather.vue写下这样一段代码
接下来就该去 Father.vue 组件去接收这个数据了。于是我们在 Father.vue 组件定义了 props 去接收这个值。

我们看一眼页面

没什么问题，爸爸组件已经收到了。但是别忘了我们任务还没完成呢，我们的需求是给儿子组件使用，
于是我们又赶紧接着往下传递。
所以现在我们的 Children.vue 组件的样子就变成这个样子。

页面效果如下:

最终我们的 儿子组件 也确实拿到了。
写到这里你发现了一些不太对劲的地方吗？🤔
其实我们的爸爸组件是完全不需要知道这些属性的，它仅仅只是充当了一个传话筒。如果这个组件单纯是这一个使用场景还好，但是一旦我们想要在第二个地方复用爸爸组件的时候，我们会发现问题就来了。我们必须给这个爸爸组件提供一个叫做 message1 的 props，但是实际上这个 message1 并不是一个爸爸组件内部自己使用的一个属性。
写到这里你发现了，仅仅只多传递了一层，就导致组件的复用性变得很差。这还是仅仅只嵌套了三层的场景，一旦到了第四层，你会发现事情逐渐开始变得棘手起来了，好像 props 并不是一个好的选择了。
想到这里你会开始思考，有没有更好的解决方法呢？🤔你别说，还真有，那就是我们今天的主角，provide 和 inject。

三. provide 和 inject

首先不要死记硬背 api 的名字，作者起名字肯定都是有原因的。在很多情况下我们通过先看这两个单词的意思。
单从这两个单词的含义就大概能猜出个大概的意思，一个是提供某个值，另一个是去注册，接收这个值。
那么问题就引出来了，我们怎么正确的使用这两个 api 呢？其实很简单，让我们回到爷爷组件，还原他最初的模样。
你做的仅仅只需要两步：

或许你会惊讶，就这样就行了？我明确告诉你，是的，这样就行了。
接下来最后一步，去儿子组件接收使用就大功告成了。

我们看一下页面效果:
不仅仅数据成功拿到了，而且关键的是我们的爸爸组件是干干净净的，丝毫不影响其他地方对它的引用。
我们再回过头讲解 provide 的用法。provide 接受两个参数。第一个参数需要是一个独一无二的标识（不允许和组件内部的变量重名），第二个参数就是准备传递的值。
你也可以这样理解，现在爷爷组件拿着一个喇叭在喊🎺：“谁要‘韩振方’，谁要‘韩振方’，价格便宜，仅仅需要一个‘message’”。
这时候儿子组件听到了这个消息，大喊：“我要我要！！”于是它就赶紧 inject 了一个 “message”。

注意： 你用于接受的变量名字是随便起的，不需要你和前面保持一致。
而爸爸组件丝毫不想要，所以它就压根不需要 inject。
并且 inject 还可以允许你有个兜底的行为。什么意思? 假设这个儿子组件在别的地方也需要复用，但是它的爷爷组件或者它压根就没有爷爷组件，那么第二个参数将作为 suibian 的默认值。
我们测试一下，我们首先取消了爷爷组件的 provide 行为。

可以看到，页面正确的显示了我们的兜底数据。

三. provide 的进阶用法

provide 的作用远远不止提供字符串类型数据而已，我们在爷爷组件声明一个响应式的数据试试。
让我们看一下儿子组件是否可以正确的响应。

可以看到，确实是可以的。
现在儿子组件长大了，它说我自己也想控制数字的增长，可以吗？爷爷组件是很宠孙子的，于是又提供了一个方法给孙子使用。
儿子组件真的可以自己控制吗？孩子真的长大了吗？

我们测试一下：

可以看到儿子组件确实是长大了（指成功 inject 了爷爷组件 provide 的函数）
千万不要转头就忘，第二个参数是我们的兜底行为。如果爷爷没提供函数，我就自己使用一个没有任何行为的箭头函数。仅此而已。

四. 源码

爷爷组件代码

<script lang="ts" setup>
// 这是爷爷组件
import { ref } from "vue";
import { provide } from "vue";

import Father from "./Father.vue";

const count = ref<number>(0);
function add() {
  count.value = count.value + 1;
}

provide("message", count);
provide("messageAdd", add); //我把 add 也同时提供给儿子组件
</script>
<template>
  <div class="w-full h-[300px] bg-[black]">
    <span class="text-white text-[20px]">爷爷组件</span>
    <button @click="add">message+1</button>
    <Father />
  </div>
</template>

父亲组件代码

<script lang="ts" setup>
// 这是父亲组件
import Children from "./Children.vue";
</script>
<template>
  <div class="w-[70%] h-[270px] bg-[pink]">
    <span class="text-[black] text-[20px]">爸爸组件</span>
    <span class="text-[black] text-[15px]"></span>
    <Children />
  </div>
</template>

儿子组件代码

<script lang="ts" setup>
// 这是儿子组件

import { inject } from "vue";

const suibian = inject("message", "假如爷爷没提供没有的话就用我");
const add = inject("messageAdd", () => {});
</script>
<template>
  <div class="w-[70%] h-[230px] bg-[white]">
    <span class="text-[black] text-[20px]">儿子组件</span>
    <span class="text-[black] text-[10px]">{{ suibian }}</span>
    <button @click="add">长大了，我自己+1</button>
  </div>
</template>