Vue 3 组件通信：通过自定义事件控制子组件的显示与隐藏

心靈之曲

发布时间：2025-09-12 13:16:01

272人浏览过

来源于php中文网

原创

Vue 3 组件通信：通过自定义事件控制子组件的显示与隐藏

本文详细介绍了在 Vue 3 中，如何通过自定义事件（$emit）实现父组件对子组件显示状态的有效管理。当子组件需要通知父组件执行某个操作（如关闭自身）时，父组件监听子组件发出的事件并更新其内部状态，从而实现跨组件的交互控制，特别适用于模态框、表单等场景的开启与关闭逻辑。

1. 问题背景与场景分析

在 vue.js 应用开发中，组件化是核心思想。我们经常会遇到这样的场景：一个父组件（例如 nav.vue）负责管理某个状态（例如一个布尔类型的 showaddcountdownform），这个状态决定了一个子组件（例如 addcountdownform.vue）的显示与隐藏。父组件可以通过修改 showaddcountdownform 的值来控制子组件的可见性。

例如，在 Nav.vue 中，点击一个按钮可以设置 showAddCountdownForm.value = true，从而显示 AddCountdownForm。然而，当用户在 AddCountdownForm 内部完成操作或点击“关闭”按钮时，如何通知 Nav.vue 将 showAddCountdownForm 设置回 false，从而隐藏表单呢？由于 showAddCountdownForm 定义在 Nav.vue 中，AddCountdownForm.vue 无法直接访问并修改它。

2. 解决方案：使用自定义事件（Custom Events）

Vue 3 提供了一种标准的父子组件通信机制来解决这个问题：自定义事件（Custom Events）。子组件可以通过 $emit 方法触发一个自定义事件，并将数据传递给父组件。父组件则通过在子组件标签上监听这个事件，并在事件触发时执行相应的处理函数来更新自身状态。

这种机制遵循了“单向数据流”的原则：数据从父组件流向子组件（通过 props），而事件从子组件流向父组件，避免了直接修改父组件状态可能带来的混乱。

3. 实现步骤

我们将通过修改 Nav.vue 和 AddCountdownForm.vue 来实现这一功能。

立即学习“前端免费学习笔记（深入）”；

3.1 子组件 AddCountdownForm.vue 发送关闭事件

首先，在 AddCountdownForm.vue 中，我们需要在用户点击“关闭”操作时，通知父组件。

代码解析：

在
close
元素上，我们添加了一个 @click="$emit('close')" 事件监听器。
$emit('close') 是 Vue 3 中用于触发自定义事件的方法。第一个参数是事件的名称（这里是 'close'），后续参数可以是要传递给父组件的数据。在这个场景中，我们只需要通知父组件关闭，所以不需要传递额外数据。
最佳实践： 在 script setup 中，可以使用 defineEmits(['close']) 显式声明组件可以发出的事件。这有助于提供更好的类型检查和代码可读性。

3.2 父组件 Nav.vue 监听并处理关闭事件

接下来，在 Nav.vue 中，当渲染 AddCountdownForm 组件时，我们需要监听它发出的 'close' 事件，并在事件触发时更新 showAddCountdownForm 的值。

AlegroCart

AlegroCart新功能：维类：包括在这两种线性长宽高或面积或体积长波产品尺寸允许与期权产品：让产品/期权组合独特的数量，尺寸，图像和型号。选择店铺标识管理图片放大镜：显示一个图片放大上空盘旋时，产品形象弹出框。自定义错误报告：设置在管理员启用。开发者只可以显示详细的信息。错误信息都写入到错误日志文件每天可以通过电子邮件发送给管理员。仓库皮卡航运模块：允许客户指定产品在商店的位置回升。增加了

下载

代码解析：

在 Nav.vue 的
我们还定义了一个 handleCloseForm 函数，它的作用是将 showAddCountdownForm.value 设置为 false。
在
App.vue 作为根组件，只需简单地引入并使用 Nav 组件即可：

4. 注意事项与最佳实践

事件命名： 建议使用 kebab-case（烤串命名法，如 my-event）来命名自定义事件，尽管 Vue 3 也可以处理 camelCase（驼峰命名法），但 kebab-case 在模板中使用时更符合 HTML 属性的命名习惯。
传递数据： 如果子组件需要向父组件传递数据，可以在 $emit 的第二个及后续参数中提供。例如：$emit('update:value', newValue)。父组件的事件处理函数会接收这些参数：@update:value="handleUpdate"，其中 handleUpdate(newValue)。
显式声明事件： 在 script setup 中，使用 defineEmits 宏来显式声明组件将发出的事件，这提供了更好的代码可读性和类型检查，尤其是在使用 TypeScript 时。
替代方案：
- Props： 对于父组件向子组件传递数据，props 是首选。
- v-model： 如果子组件需要双向绑定父组件的某个属性（例如表单输入），可以使用 v-model 语法糖，它本质上是 prop 和 emit 的结合。
- provide/inject： 对于跨多层嵌套组件的通信，provide/inject 提供了一种在祖先组件和后代组件之间共享状态的方式。
- Vuex/Pinia： 对于大型应用或需要全局状态管理的情况，使用状态管理库（如 Vuex 或 Pinia）是更合适的选择。

5. 总结

通过自定义事件，Vue 3 提供了一种清晰、高效且遵循单向数据流原则的父子组件通信方式。在子组件中触发事件，父组件监听并响应，这种模式使得组件间的协作变得简单而可维护。掌握自定义事件是构建健壮和可扩展 Vue 应用的关键技能之一，尤其适用于控制模态框、弹出层或表单等组件的显示与隐藏逻辑。

javascript框架是什么_为什么需要学习Vue或React【教程】

Vue 3 中使用 v-model 实现子组件对父组件 prop 的双向绑定

Vue 3 中使用 v-model 实现父子组件间 show 状态的双向绑定

javascript框架如何选择_react、vue和angular各有什么特点【教程】

VueJS 中等待所有 API 请求完成后再渲染表单的正确实践

相关专题

js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法，还有更多js正则表达式的相关文章、相关下载、相关课程，供大家免费下载体验。

514

2023.06.20

js获取当前时间

JS全称JavaScript，是一种具有函数优先的轻量级，解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言，主要用于Web，常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢？php中文网给大家带来了相关的教程以及文章，欢迎大家前来学习阅读。

244

2023.07.28

js 字符串转数组

js字符串转数组的方法：1、使用“split()”方法；2、使用“Array.from()”方法；3、使用for循环遍历；4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容，供大家免费下载体验。

298

2023.08.03

js是什么意思

JS是JavaScript的缩写，它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言，通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果，如表单验证、页面元素操作、动画效果、数据交互等。

5309

2023.08.17

js删除节点的方法

js删除节点的方法有：1、removeChild()方法，用于从父节点中移除指定的子节点，它需要两个参数，第一个参数是要删除的子节点，第二个参数是父节点；2、parentNode.removeChild()方法，可以直接通过父节点调用来删除子节点；3、remove()方法，可以直接删除节点，而无需指定父节点；4、innerHTML属性，用于删除节点的内容。

481

2023.09.01

js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容，供大家免费下载体验。

212

2023.09.04

Js中concat和push的区别

Js中concat和push的区别：1、concat用于将两个或多个数组合并成一个新数组，并返回这个新数组，而push用于向数组的末尾添加一个或多个元素，并返回修改后的数组的新长度；2、concat不会修改原始数组，是创建新的数组，而push会修改原数组，将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容，供大家免费下载体验。

218

2023.09.14