【vue】非父子组件通信和插槽使用

一.非父子组件之间通信

在开发中，我们构建了组件树之后，除了父子组件之间的通信之外，还会有非父子组件之间的通信。

这里我们主要讲两种方式：

• Provide/Inject
• Mitt全局事件总线；

1.1. Provide/Inject

Provide/Inject用于非父子组件之间共享数据：

• 比如有一些深度嵌套的组件，子组件想要获取父组件的部分内容；
• 在这种情况下，如果我们仍然将props沿着组件链逐级传递下去，就会非常的麻烦；

对于这种情况下，我们可以使用 Provide 和 Inject ：

• 无论层级结构有多深，父组件都可以作为其所有子组件的依赖提供者；
• 父组件有一个 provide 选项来提供数据；
• 子组件有一个 inject 选项来开始使用这些数据；

实际上，你可以将依赖注入看作是“long range props”，除了：

• 父组件不需要知道哪些子组件使用它 provide 的 property
• 子组件不需要知道 inject 的 property 来自哪里

1.1.1. 基本使用

我们开发一个这样的结构：

App.vue组件提供数据：

<template>
	<div>
		<home></home>
	</div>
</template>
<script>
	import Home from './Home.vue';
	export default {
		components: {
			Home
		},
		provide: {
			name: "why",
			age: 18
		}
	}
</script>

Home.vue是中间的组件：

<template>
	<div>
		<home-content></home-content>
	</div>
</template>
<script>
	import HomeContent from './HomeContent.vue';
	export default {
		components: {
			HomeContent
		}
	}
</script>

HomeContent.vue是获取数据的组件：

<template>
	<div>
		<h2>HomeContent</h2>
		<h2>{{name}}-{{age}}</h2>
	</div>
</template>
<script>
	export default {
		inject: ["name", "age"]
	}
</script>

1.1.2. 函数写法

如果Provide中提供的一些数据是来自data，那么我们可能会想要通过this来获取：

这个时候会报错：

这里this使用的是哪里的this？

如何解决这个问题呢？

• 我们需要将provide转成为返回对象的函数；

1.1.3. 处理响应式

我们先来验证一个结果：如果我们修改了this.names的内容，那么使用length的子组件会不会是响应式的？

<template>
	<div>
		<home></home> <button @click="addName">添加name</button>
	</div>
</template>
<script>
	import Home from './Home.vue';
	export default {
		components: {
			Home
		},
		data() {
			return {
				names: ["abc", "cba"]
			}
		},
		provide() {
			return {
				name: "why",
				age: 18,
				length: this.names.length
			}
		},
		methods: {
			addName() {
				this.names.push("why");
			}
		}
	}
</script>

我们会发现对应的子组件中是没有反应的：

• 这是因为当我们修改了names之后，之前在provide中引入的 this.names.length 本身并不是响应式的；

那么怎么样可以让我们的数据变成响应式的呢？

• 非常的简单，我们可以使用响应式的一些API来完成这些功能，比如说computed函数；
• 当然，这个computed是vue3的新特性，在后面我会专门讲解，这里大家可以先直接使用一下；

注意：我们在使用length的时候需要获取其中的value

• 这是因为computed返回的是一个ref对象，需要取出其中的value来使用；

• Provide和Inject也可以在Composition API中使用，后续我们会讲到的。

1.2. 全局事件总线

Vue3从实例中移除了 $on、$off 和 $once 方法，所以我们如果希望继续使用全局事件总线，要通过第三方的库：

• Vue3官方有推荐一些库，例如 mitt 或 tiny-emitter；
• 这里我们主要讲解一下mitt库的使用；

首先，我们需要先安装这个库：

npm install mitt

其次，我们可以封装一个工具eventbus.js：

import mitt from 'mitt';
// 可以创建很多个emitter对象
const emitter = mitt();
export default emitter;

在项目中可以使用它们：

• 我们在Home.vue中监听事件；
• 我们在App.vue中触发事件；

Home.vue组件中监听事件：

<template>
	<div> </div>
</template>
<script>
	import emitter from './eventBus';
	export default {
		created() {
			emitter.on("why", (info) => {
				console.log("why event:", info);
			});
			emitter.on("kobe", (info) => {
				console.log("kobe event:", info);
			}) emitter.on("*", (type, e) => {
				console.log("* event:", type, e);
			});
		}
	}
</script>

App.vue中触发事件：

<template>
	<div>
		<home /> <button @click="triggerEvent">触发事件</button> </div>
</template>
<script>
	import Home from './Home.vue';
	import emitter from './eventBus';
	export default {
		components: {
			Home
		},
		methods: {
			triggerEvent() {
				emitter.emit("why", {
					name: "why",
					age: 18
				});
			}
		}
	}
</script>

其他API的补充，如果在某些情况下我们想要取消事件，可以使用下面的API：

// 取消emitter中所有的监听
emitter.all.clear()
// 定义一个函数
function onFoo() {}
emitter.on('foo', onFoo)   // 监听
emitter.off('foo', onFoo)  // 取消监听

二. 插槽的使用

2.1. 认识插槽slot

在开发中，经常封装一个个可复用的组件：

• 之前我们通过props传递给组件一些数据，让组件来进行展示；
• 但是为了让这个组件具备更强的通用性，我们不能将组件中的内容限制为固定的div、span等等这些元素；
• 比如某种情况下我们使用组件希望组件显示的是一个按钮，某种情况下我们使用组件希望显示的是一张图片；
• 我们应该让使用者可以决定某一块区域到底存放什么内容；

举个栗子：假如我们定制一个通用的导航组件 - NavBar

• 这个组件分成三块区域：左边-中间-右边，每块区域的内容是不固定；
• 左边区域可能显示一个菜单图标，也可能显示一个返回按钮，可能什么都不显示；
• 中间区域可能显示一个搜索框，也可能是一个列表，也可能是一个标题，等等；
• 右边可能是一个文字，也可能是一个图标，也可能什么都不显示；

这个时候我们就可以来定义插槽slot：

• 插槽的使用过程其实是抽取共性、预留不同；
• 我们会将共同的元素、内容依然在组件内进行封装；
• 同时会将不同的元素使用slot作为占位，让外部决定到底显示什么样的元素；

如何使用slot呢？

• Vue中将 元素作为承载分发内容的出口；
• 在封装组件中，使用特殊的元素就可以为封装组件开启一个插槽；
• 该插槽插入什么内容取决于父组件如何使用；

2.2. 插槽的使用

2.2.1. 插槽的基本使用

我们一个组件MySlotCpn.vue：

该组件中有一个插槽，我们可以在插槽中放入需要显示的内容；

<template>
  <div>
    <h2>MySlotCpn开始</h2>
    <slot></slot>
    <h2>MySlotCpn结尾</h2>
  </div>
</template>

我们在App.vue中使用它们：

• 我们可以插入普通的内容、html元素、组件元素，都可以是可以的；

<template>
  <div>
    <my-slot-cpn>
      <!-- 1.普通的内容 -->
      Hello World
      <!-- 2.html元素 -->
      <button>我是按钮</button>
      <!-- 3.组件元素 -->
      <my-button></my-button>
    </my-slot-cpn>
  </div>
</template>

2.2.2. 插槽的默认内容

有时候我们希望在使用插槽时，如果没有插入对应的内容，那么我们需要显示一个默认的内容：

• 当然这个默认的内容只会在没有提供插入的内容时，才会显示；

2.2.3. 具名插槽的使用

我们先测试一个知识点：如果一个组件中含有多个插槽，我们插入多个内容时是什么效果？

• 我们会发现默认情况下每个插槽都会获取到我们插入的内容来显示；

事实上，我们希望达到的效果是插槽对应的显示，这个时候我们就可以使用 具名插槽：

• 具名插槽顾名思义就是给插槽起一个名字， 元素有一个特殊的 attribute：name；
• 一个不带 name 的slot，会带有隐含的名字 default；

<template>
  <div class="nav-bar">
    <div class="left">
      <slot></slot>
    </div>
    <div class="center">
      <slot></slot>
    </div>
    <div class="right">
      <slot></slot>
    </div>
  </div>
</template>

在向具名插槽提供内容的时候，我们可以在一个 元素上使用 v-slot 指令，并以 v-slot 的参数的形式提供其名称：

<template>
  <div>
    <nav-bar>
      <template v-slot:left>
        <button>左边按钮</button>
      </template>
      <template v-slot:center>
        <h2>中间标题</h2>
      </template>
      <template v-slot:right>
        <i>右边i元素</i>
      </template>
    </nav-bar>
  </div>
</template>

插槽的使用过程如下：

动态插槽名：

• 目前我们使用的插槽名称都是固定的；
• 比如 v-slot:left、v-slot:center等等；
• 我们可以通过 v-slot:[dynamicSlotName]方式动态绑定一个名称；

具名插槽使用的时候缩写：

• 跟 v-on 和 v-bind 一样，v-slot 也有缩写；
• 即把参数之前的所有内容 (v-slot:) 替换为字符 #；

<template>
  <div>
    <nav-bar>
      <template #left>
        <button>左边按钮</button>
      </template>
      <template #center>
        <h2>中间标题</h2>
      </template>
      <template #right>
        <i>右边i元素</i>
      </template>
    </nav-bar>
  </div>
</template>

三. 作用域插槽

3.1. 渲染作用域

在Vue中有渲染作用域的概念：

• 父级模板里的所有内容都是在父级作用域中编译的；
• 子模板里的所有内容都是在子作用域中编译的；

如何理解这句话呢？我们来看一个案例：

• 在我们的案例中ChildCpn自然是可以让问自己作用域中的title内容的；
• 但是在App中，是访问不了ChildCpn中的内容的，因为它们是跨作用域的访问；

3.2. 作用域插槽

但是有时候我们希望插槽可以访问到子组件中的内容是非常重要的：

• 当一个组件被用来渲染一个数组元素时，我们使用插槽，并且希望插槽中没有显示每项的内容；
• 这个Vue给我们提供了作用域插槽；

我们来看下面的一个案例：

• 1.在App.vue中定义好数据
• 2.传递给ShowNames组件中
• 3.ShowNames组件中遍历names数据
• 4.定义插槽的prop
• 5.通过v-slot:default的方式获取到slot的props
• 6.使用slotProps中的item和index

具体的代码如下：

App.vue代码：

<template>
  <div>
    <show-names :names="names">
      <template v-slot:default="slotProps">
        <span>{{slotProps.item}}-{{slotProps.index}}</span>
      </template>
    </show-names>
  </div>
</template>

<script>
  import ShowNames from './ShowNames.vue';

  export default {
    components: {
      ShowNames,
    },
    data() {
      return {
        names: ["why", "kobe", "james", "curry"]
      }
    }
  }
</script>

ShowNames.vue代码：

<template>
  <div>
    <template v-for="(item, index) in names" :key="item">
      <!-- 插槽prop -->
      <slot :item="item" :index="index"></slot>
    </template>
  </div>
</template>

<script>
  export default {
    props: {
      names: {
        type: Array,
        default: () => []
      }
    }
  }
</script>

3.3. 独占默认插槽

如果我们的插槽是默认插槽default，那么在使用的时候 v-slot:default="slotProps"可以简写为v-slot=“slotProps”：

<show-names :names="names">
  <template v-slot="slotProps">
		<span>{{slotProps.item}}-{{slotProps.index}}</span>
  </template>
</show-names>

并且如果我们的插槽只有默认插槽时，组件的标签可以被当做插槽的模板来使用，这样，我们就可以将 v-slot 直接用在组件上：

<show-names :names="names" v-slot="slotProps">
  <span>{{slotProps.item}}-{{slotProps.index}}</span>
</show-names>

但是，如果我们有默认插槽和具名插槽，那么按照完整的template来编写。

只要出现多个插槽，请始终为所有的插槽使用完整的基于 的语法：

一张图理解插槽：