Vue3组件通信详解：父传子、子传父与兄弟组件通信

前言

在Vue3中，组件之间的通信是构建复杂应用程序的基础。组件通信主要包括父传子、子传父以及兄弟组件通信。本文将详细讲解这三种通信方式，并通过代码示例进行演示。

父传子通信（Props）

父传子通信是Vue中最基本也是最常用的通信方式。父组件通过属性（props）向子组件传递数据。

示例代码：

父组件（ParentComponent.vue） ：

	<template>

	  <div>

	    <child-component :message="parentMessage" :userInfo="userInfo"></child-component>

	  </div>

	</template>

	<script setup>

	import { ref, reactive } from 'vue';

	import ChildComponent from './ChildComponent.vue';

	const parentMessage = ref('Hello from Parent');

	const userInfo = reactive({ name: 'John', age: 30 });

	</script>

子组件（ChildComponent.vue） ：

	<template>

	  <div>

	    <p>{{ message }}</p>

	    <p>{{ userInfo.name }}</p>

	  </div>

	</template>

	<script setup>

	import { defineProps } from 'vue';

	const props = defineProps({

	  message: String,
	  userInfo: Object,

	});

	</script>

在父组件中，通过v-bind指令（简写为:）将parentMessage和userInfo数据绑定到子组件的message和userInfo属性上。子组件通过defineProps函数接收这些属性，并在模板中使用。

子传父通信（Emit）

子组件可以通过触发事件的方式向父组件传递数据。Vue3中，子组件使用$emit方法触发事件，父组件通过监听这些事件来接收数据。

示例代码：

父组件（ParentComponent.vue） ：

	<template>

	  <div>

	    <child-component @update="handleUpdate" @delete="handleDelete"></child-component>

	  </div>

	</template>

	<script setup>

	import { ref } from 'vue';

	import ChildComponent from './ChildComponent.vue';

	const handleUpdate = (data) => {

	  console.log('Received from child:', data);

	};

	 
	const handleDelete = () => {

	  // 处理删除逻辑

	};

	</script>

子组件（ChildComponent.vue） ：

	<template>

	  <div>

	    <button @click="handleClick">更新父组件</button>

	  </div>

	</template>

	 

	<script setup>

	import { defineEmits } from 'vue';

	const emit = defineEmits(['update', 'delete']);

	const handleClick = () => {

	  emit('update', { id: 1, value: 'new value' });

	};

	</script>

在子组件中，通过defineEmits函数定义可以触发的事件。然后，在按钮点击事件中调用emit方法触发update事件，并传递数据给父组件。父组件通过v-on指令（简写为@）监听update和delete事件，并定义相应的事件处理函数。

兄弟组件通信

兄弟组件之间的通信通常需要通过一个共同父组件来中转，或者使用事件总线（如mitt库）来实现。

1. 通过父组件中转

父组件（ParentComponent.vue） ：

	<template>

	  <div>

	    <sibling-a @message="handleMessage" />

	    <sibling-b :message="message" />

	  </div>

	</template>

	 

	<script setup>

	import { ref } from 'vue';

	import SiblingA from './SiblingA.vue';

	import SiblingB from './SiblingB.vue';

	const message = ref('');

	const handleMessage = (value) => {

	  message.value = value;

	};

	</script>

兄弟组件A（SiblingA.vue） ：

	<template>

	  <button @click="sendMessage">发送消息</button>

	</template>

	<script setup>

	import { defineEmits } from 'vue';

	const emit = defineEmits(['message']);

	const sendMessage = () => {

	  emit('message', 'Hello from sibling A');

	};

	</script>

兄弟组件B（SiblingB.vue） ：

	<template>

	  <p>{{ message }}</p>

	</template>

	<script setup>

	import { defineProps } from 'vue';

	const props = defineProps(['message']);

	</script>

在这个例子中，兄弟组件A通过触发message事件向父组件发送数据，父组件接收到数据后更新自己的状态，并将状态通过props传递给兄弟组件B。

2. 使用事件总线（mitt）

首先，安装mitt库：

	npm install mitt

然后，在main.js中全局配置事件总线：

	import { createApp } from 'vue';

	import mitt from 'mitt';

	import App from './App.vue';

	const app = createApp(App);

	app.config.globalProperties.$bus = mitt();

	app.mount('#app');

组件A（ComponentA.vue） ：

	<template>

	  <button @click="sendMessage">发送消息</button>

	</template>

	<script setup>

	import { getCurrentInstance } from 'vue';

	const { proxy } = getCurrentInstance();

	const sendMessage = () => {

	  proxy.$bus.emit('myEvent', 'Hello from ComponentA');

	};

	</script>

组件B（ComponentB.vue） ：

	<script setup>

	import { onMounted, getCurrentInstance } from 'vue';
        
	const { proxy } = getCurrentInstance();
        
	onMounted(() => {
        
	  proxy.$bus.on('myEvent', (message) => {
          
	    console.log(message); // 输出: "Hello from ComponentA"
	  });
          
	});

	</script>

在这个例子中，组件A通过事件总线发送消息，组件B通过事件总线接收消息。这种方式不需要通过父组件中转，实现了兄弟组件之间的直接通信。

3.全局状态管理（Pinia）

通过集中式状态管理库（如 Pinia）共享全局状态。

1. 创建 Pinia Store
2. 组件 A 修改 Store 中的状态
3. 组件 B 读取 Store 中的状态

代码示例

// stores/message.js
import { defineStore } from 'pinia';

export const useMessageStore = defineStore('message', {

  state: () => ({
    content: ''
  }),
  
  actions: {
  
    setContent(newContent) {
      this.content = newContent;
    }
    
  }
});

<!-- ComponentA.vue -->
<template>
  <button @click="update">更新全局状态</button>
</template>

<script setup>
import { useMessageStore } from '@/stores/message';
const store = useMessageStore();

const update = () => {
  store.setContent('全局消息内容');
};
</script>

<!-- ComponentB.vue -->
<template>
  <div>{{ store.content }}</div>
</template>

<script setup>
import { useMessageStore } from '@/stores/message';
const store = useMessageStore();
</script>

4.Provide/Inject + 响应式数据

通过祖先组件提供响应式数据，后代组件注入使用。

1. 祖先组件使用 provide 提供数据
2. 兄弟组件使用 inject 注入数据

代码示例

<!-- Ancestor.vue -->
<template>
  <ComponentA />
  <ComponentB />
</template>

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

const sharedData = ref('初始数据');
const updateData = (newValue) => {
  sharedData.value = newValue;
};

provide('sharedContext', {
  sharedData,
  updateData
});
</script>

<!-- ComponentA.vue -->
<template>
  <button @click="update">修改共享数据</button>
</template>

<script setup>
import { inject } from 'vue';
const { updateData } = inject('sharedContext');

const update = () => {
  updateData('新数据');
};
</script>

<!-- ComponentB.vue -->
<template>
  <div>{{ sharedData }}</div>
</template>

<script setup>
import { inject } from 'vue';
const { sharedData } = inject('sharedContext');
</script>

五、共享响应式对象

创建独立的响应式对象文件供组件导入。

1. 创建共享状态文件
2. 组件直接导入使用

代码示例

// sharedState.js
import { reactive } from 'vue';

export const state = reactive({
  value: '',
  setValue(newVal) {
    this.value = newVal;
  }
});

<!-- ComponentA.vue -->
<template>
  <input v-model="state.value" />
</template>

<script setup>
import { state } from './sharedState';
</script>

<!-- ComponentB.vue -->
<template>
  <div>{{ state.value }}</div>
</template>

<script setup>
import { state } from './sharedState';
</script>

6.组件实例引用（ref）

通过 ref 直接访问组件实例方法。

1. 父组件创建 ref
2. 子组件暴露方法
3. 通过 ref 调用方法

代码示例

<!-- Parent.vue -->
<template>
  <ComponentA ref="compA" />
  <ComponentB :trigger="compA?.method" />
</template>

<script setup>
import { ref } from 'vue';
const compA = ref(null);
</script>

<!-- ComponentA.vue -->
<script setup>
const method = () => {
  console.log('组件A的方法被调用');
};

defineExpose({ method }); // 必须暴露方法
</script>

<!-- ComponentB.vue -->
<template>
  <button @click="trigger">调用方法</button>
</template>

<script setup>
defineProps(['trigger']);
</script>

方法对比与选择建议

方法	优点	缺点	推荐场景
Props + 事件	官方推荐，数据流清晰	层级深时繁琐	简单父子通信
Pinia	专业状态管理，响应式完善	需要学习成本	中大型应用
事件总线	完全解耦，灵活性强	需手动管理事件监听	临时事件通信
Provide/Inject	跨层级通信高效	数据流向不够直观	深层嵌套组件
共享对象	实现简单	难以维护	小型项目原型开发
组件实例引用	直接访问方法	破坏组件封装性	特殊场景应急使用

总结

Vue3中的组件通信方式多种多样，包括父传子（Props）、子传父（Emit）、兄弟组件通信（通过父组件中转、事件总线mitt、全局状态管理Pinia、Provide/Inject + 响应式数据、共享响应式对象、组件实例引用）。每种方式都有其优缺点和适用场景，如Props+事件适合简单父子通信，Pinia适合中大型应用，事件总线灵活但需手动管理。选择通信方式时需根据具体需求和应用规模进行权衡。