1. Vue 3 组件通信概述
在 vue 3 中，组件是构建用户界面的基本单元。为了实现复杂的功能，组件之间需要进行数据和事件的交互。vue 提供了多种组件通信机制：
- Props (父传子): 父组件通过 props 向子组件传递数据。这是最常见且推荐的单向数据流方式。
- Events (子传父): 子组件通过触发事件向父组件发送消息。这是本教程重点关注的机制。
- Slot (内容分发): 父组件向子组件的插槽中插入内容。
- Provide/Inject (祖孙组件通信): 适用于跨多层组件传递数据，避免逐层传递 props。
- v-model (双向绑定语法糖): 简化了父子组件间特定场景下的双向数据绑定。
- 状态管理库 (如 Pinia/Vuex): 适用于管理大型应用中的全局状态。
本教程将聚焦于如何利用自定义事件解决子组件需要通知父组件更新其状态的场景。
2. 场景分析：子组件关闭父组件控制的模态框
考虑一个常见的 UI 交互：父组件 Nav.vue 控制一个模态框 AddCountdownForm.vue 的显示与隐藏。当用户点击 Nav.vue 中的“添加”按钮时，模态框显示。现在的问题是，模态框内部通常会有一个“关闭”按钮，用户点击该按钮时，模态框应该隐藏。
在这种情况下，模态框的显示状态 (showAddCountdownForm) 是由父组件 Nav.vue 管理的。子组件 AddCountdownForm.vue 无法直接修改父组件的响应式数据。如果子组件尝试直接修改父组件的 prop，Vue 会发出警告，因为这违反了单向数据流的原则。正确的做法是，子组件通知父组件，由父组件来更新其自身的状态。
3. 解决方案：使用自定义事件 $emit
Vue 3 提供了 $emit 方法，允许子组件触发一个自定义事件。父组件可以在子组件的实例上监听这个事件，并在事件触发时执行相应的逻辑。
立即学习“前端免费学习笔记（深入）”；
3.1 子组件 AddCountdownForm.vue 的实现
在子组件中，我们需要做两件事：
- 声明组件可以触发的事件。
- 在用户交互时触发这些事件。
在 script setup 语法中，我们使用 defineEmits 宏来声明组件可以发出的事件。
<!-- components/AddCountdownForm.vue -->
<script setup>
// 使用 defineEmits 声明组件可以发出的事件
// 'close' 是我们自定义的事件名称
const emit = defineEmits(['close']);
</script>
<template>
<div
class="h-screen w-full bg-gray-200/50 backdrop-blur-sm relative flex md:justify-center md:items-center"
>
<div
class="absolute h-1/2 w-full bg-gray-300 bottom-0 md:bottom-auto md:w-1/2"
>
<div class="w-full bg-white h-12 ml-0">
<!-- 当用户点击“close”文本时，触发名为 'close' 的自定义事件 -->
<div @click="emit('close')" class="cursor-pointer p-2">关闭</div>
</div>
<div class="p-4">模态框内容</div>
</div>
</div>
</template>代码解析：
- const emit = defineEmits(['close']);：这行代码声明了 AddCountdownForm 组件可以触发一个名为 close 的自定义事件。emit 函数是用于实际触发事件的。
- <div @click="emit('close')">关闭</div>：当用户点击这个 div 元素时，emit('close') 会被调用，从而向其父组件触发一个 close 事件。
3.2 父组件 Nav.vue 的实现
在父组件中，我们需要监听子组件发出的 close 事件，并在事件触发时更新 showAddCountdownForm 的值。
<!-- components/Nav.vue -->
<script setup>
import { ref } from "vue";
import AddCountdownForm from "./AddCountdownForm.vue"; // 确保路径正确
const showAddCountdownForm = ref(false);
// 当子组件 AddCountdownForm 触发 'close' 事件时，执行此函数
const handleCloseForm = () => {
showAddCountdownForm.value = false;
};
</script>
<template>
<div class="relative">
<nav class="w-full top-0 fixed h-20 bg-gray-200 backdrop-blur-xl mb-14">
<div
class="container h-full p-1 flex items-centerm justify-between"
>
<!-- 点击此按钮显示模态框 -->
<div
class="my-auto w-14 h-14 p-1 cursor-pointer relative transition-all"
id="addBtn"
@click="showAddCountdownForm = true"
>
<p class="text-indigo-500 text-3xl">+</p>
</div>
<!-- 其他导航元素 -->
<div class="my-auto w-14 h-14 p-1 cursor-pointer relative" id="setting">
<p class="text-indigo-500 text-3xl">...</p>
</div>
</div>
</nav>
<!-- 渲染 AddCountdownForm 组件 -->
<!-- 使用 v-show 控制其显示/隐藏 -->
<!-- 监听子组件的 'close' 事件，当事件触发时调用 handleCloseForm 方法 -->
<AddCountdownForm v-show="showAddCountdownForm" @close="handleCloseForm" />
</div>
</template>代码解析：
- const showAddCountdownForm = ref(false);：这是父组件中控制模态框显示状态的响应式数据。
- <AddCountdownForm v-show="showAddCountdownForm" @close="handleCloseForm" />：
- v-show="showAddCountdownForm"：根据 showAddCountdownForm 的值来显示或隐藏 AddCountdownForm 组件。
- @close="handleCloseForm"：这是监听自定义事件的关键。@close 是 v-on:close 的简写，它表示当 AddCountdownForm 组件触发 close 事件时，会调用父组件的 handleCloseForm 方法。
- const handleCloseForm = () => { showAddCountdownForm.value = false; };：这个方法负责将 showAddCountdownForm 设置为 false，从而隐藏模态框。
4. 完整代码示例
为了演示完整的工作流程，以下是 App.vue、Nav.vue 和 AddCountdownForm.vue 的代码。
App.vue
<!-- App.vue --> <script setup> import Nav from "./components/Nav.vue"; </script> <template> <Nav/> </template>
components/Nav.vue
<!-- components/Nav.vue -->
<script setup>
import { ref } from "vue";
import AddCountdownForm from "./AddCountdownForm.vue";
const showAddCountdownForm = ref(false);
const handleCloseForm = () => {
showAddCountdownForm.value = false;
};
</script>
<template>
<div class="relative">
<nav class="w-full top-0 fixed h-20 bg-gray-200 backdrop-blur-xl mb-14">
<div
class="container h-full p-1 flex items-centerm justify-between"
>
<!-- 点击此按钮显示模态框 -->
<div
class="my-auto w-14 h-14 p-1 cursor-pointer relative transition-all"
id="addBtn"
@click="showAddCountdownForm = true"
>
<p class="text-indigo-500 text-3xl">+</p>
</div>
<!-- 其他导航元素 -->
<div class="my-auto w-14 h-14 p-1 cursor-pointer relative" id="setting">
<p class="text-indigo-500 text-3xl">...</p>
</div>
</div>
</nav>
<AddCountdownForm v-show="showAddCountdownForm" @close="handleCloseForm" />
</div>
</template>components/AddCountdownForm.vue
<!-- components/AddCountdownForm.vue -->
<script setup>
const emit = defineEmits(['close']);
</script>
<template>
<div
class="h-screen w-full bg-gray-200/50 backdrop-blur-sm relative flex md:justify-center md:items-center"
>
<div
class="absolute h-1/2 w-full bg-gray-300 bottom-0 md:bottom-auto md:w-1/2"
>
<div class="w-full bg-white h-12 ml-0">
<div @click="emit('close')" class="cursor-pointer p-2">关闭</div>
</div>
<div class="p-4">模态框内容</div>
</div>
</div>
</template>5. 注意事项与最佳实践
- 事件命名规范： 建议使用 kebab-case（烤串命名法，如 my-event）来命名自定义事件。虽然 Vue 允许使用 camelCase（驼峰命名法），但在模板中监听时通常会自动转换为 kebab-case，为避免混淆，最好保持一致。
- 传递数据： 自定义事件不仅可以通知父组件发生了什么，还可以携带数据。例如，如果子组件需要传递一个 ID 或其他信息，可以在 emit 调用中作为第二个参数传递：emit('itemSelected', itemId)。父组件监听时，事件处理器会自动接收这些参数：@item-selected="handleItemSelected"，handleItemSelected(id) { /* ... */ }。
- 替代方案：v-model： 对于父子组件间需要双向绑定的场景（例如表单输入），Vue 提供了 v-model 语法糖。它本质上是 prop 和 emit 事件的组合，简化了代码。例如，v-model:visible 相当于传递 visible prop 并监听 update:visible 事件。
- 深层嵌套组件通信：provide/inject： 当组件层级较深时，如果仍使用事件逐层向上冒泡，会变得非常繁琐。provide/inject 机制允许祖先组件提供数据或方法，孙子组件可以直接注入使用，无需经过中间组件。
- 全局状态管理：Pinia/Vuex： 对于大型应用，如果多个组件（包括不相关的组件）需要共享和修改同一份状态，那么使用 Pinia 或 Vuex 等状态管理库是更合适的选择。它们提供了一个集中的状态存储，并强制执行状态变更规则，使应用状态更易于预测和调试。
6. 总结
通过自定义事件 ($emit)，Vue 3 提供了一种清晰、高效且符合单向数据流原则的子组件向父组件通信的方式。这种模式使得子组件能够通知父组件进行状态更新，而无需直接修改父组件的数据，从而保持了组件的独立性和可维护性。掌握这一机制是构建响应式和可扩展 Vue 应用的关键一步。
