一文带你深入理解Vue3中的emit使用

 更新时间:2025年01月13日 09:36:11   作者:OEC小胖胖  
这篇文章主要介绍了Vue3中通过emit实现父子组件通信的方法,包括基础概念、使用方法、配合props实现完整父子通信、在TypeScript中的类型推断以及注意事项与最佳实践,需要的朋友可以参考下

前言

在 Vue 3 中,组件通信是开发中非常重要的一部分,其中通过 emit 实现父子组件通信是最常见的方式之一。emit 的作用是:子组件可以通过触发自定义事件将数据传递给父组件

一、基础概念

什么是 emit?

emit 是 Vue 提供的一个方法,允许子组件通过事件触发的方式与父组件进行通信。父组件通过监听事件来响应子组件的行为。

使用场景

  • 子组件通知父组件发生了某些行为(如按钮点击)。
  • 子组件向父组件传递数据。

二、使用方法与语法

子组件中触发事件

在 setup 中,通过组件实例的 emit 函数触发事件。使用 defineProps 和 defineEmits 是 Vue 3 中推荐的组合式 API 语法。

示例代码

<!-- 子组件 -->
<script setup>
import { defineEmits } from 'vue';

// 定义触发的事件及其数据类型
const emit = defineEmits(['update', 'delete']);

// 触发事件
const handleUpdate = () => {
  emit('update', { id: 1, name: 'Vue 3' });
};

const handleDelete = () => {
  emit('delete', 1); // 触发 delete 事件,传递一个 ID
};
</script>

<template>
  <button @click="handleUpdate">更新</button>
  <button @click="handleDelete">删除</button>
</template>

父组件中监听事件

<!-- 父组件 -->
<script setup>
import ChildComponent from './ChildComponent.vue';

const handleUpdate = (data) => {
  console.log('更新事件触发:', data);
};

const handleDelete = (id) => {
  console.log('删除事件触发,ID:', id);
};
</script>

<template>
  <ChildComponent @update="handleUpdate" @delete="handleDelete" />
</template>

三、配合 props 实现完整父子通信

子组件与父组件完整通信流程

  • 父组件通过 props 将数据传递给子组件
  • 子组件通过 emit 将事件通知给父组件

示例代码

<!-- 子组件 -->
<script setup>
import { defineProps, defineEmits } from 'vue';

// 定义 props 和 emit
const props = defineProps({
  value: String
});

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

// 修改输入时触发 input 事件
const handleInput = (event) => {
  emit('input', event.target.value);
};
</script>

<template>
  <input :value="value" @input="handleInput" />
</template>
<!-- 父组件 -->
<script setup>
import ChildComponent from './ChildComponent.vue';
import { ref } from 'vue';

const inputValue = ref('初始值');

const handleInput = (value) => {
  inputValue.value = value;
};
</script>

<template>
  <ChildComponent :value="inputValue" @input="handleInput" />
  <p>父组件中的值:{{ inputValue }}</p>
</template>

四、在 TypeScript 中的类型推断

Vue 3 的组合式 API 提供了强大的类型支持。通过 defineEmits 和 defineProps,可以轻松为事件添加类型约束。

示例代码

<script setup lang="ts">
import { defineEmits, defineProps } from 'vue';

// 定义 props 类型
interface Props {
  value: string;
}

// 定义 emits 类型
type Emits = {
  (event: 'input', value: string): void;
  (event: 'delete'): void;
};

const props = defineProps<Props>();
const emit = defineEmits<Emits>();

// 使用 emit
const handleInput = (value: string) => {
  emit('input', value);
};

const handleDelete = () => {
  emit('delete');
};
</script>

五、注意事项与最佳实践

  • 事件名称统一采用 kebab-case 格式

    • 虽然 Vue 会自动处理大小写,但使用 kebab-case 是推荐的实践,避免大小写不一致的问题。
    emit('update-value'); // 推荐
    emit('updateValue'); // 不推荐
    
  • 合理规划事件名称

    • 避免事件名称过于通用,确保具有上下文意义。例如,update 可以修改为 update-user,使其更具描述性。
  • 避免过度依赖 emit

    • 如果父组件过多依赖子组件的事件,可能导致父组件的逻辑复杂度增加。可以考虑使用 Vuex、Pinia 等状态管理工具。
  • 事件参数的结构化

    • 如果需要传递多个参数,建议使用对象,这样更容易扩展和维护。
    emit('update', { id: 1, name: 'Vue 3' }); // 推荐
    emit('update', 1, 'Vue 3'); // 不推荐
    

六、总结

emit 是 Vue 3 中实现父子组件通信的核心工具,它的使用非常灵活,适合小型应用中的局部通信。搭配 props 使用,可以实现完整的数据流动。

附:注意事项

1、事件名称区分大小写

Vue 3 中的事件名称是区分大小写的。这意味着 @update 和 @Update 是两个不同的事件名称。在子组件和父组件中,确保事件名称的一致性非常重要。

2、事件参数传递

使用 emit 可以传递多个参数,这些参数将在父组件中对应的事件处理函数中接收到,并且需要按照顺序正确接收它们。

// 子组件
emit('update', 'value1', 'value2');

// 父组件
<Child @update="handleUpdate" />

<script setup>
const handleUpdate = (param1, param2) => {
  console.log(param1, param2); // param1 = 'value1', param2 = 'value2'
};
</script>

3、事件参数类型

在使用 TypeScript 时,defineEmits 可以定义事件和参数的类型。不仅可以提高代码的安全性,还能在开发过程中获得更好的类型提示。

const emit = defineEmits<{ (event: 'update', value: string): void }>();

emit('update', 'newValue'); // 正确
emit('update', 123); // 错误,类型不匹配

4、确保事件已声明

通过 defineEmits 定义子组件中的事件时,要确保所有可能触发的事件都已声明。未声明的事件将无法通过 emit 触发。

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

emit('update', 'newValue'); // 正确
emit('delete'); // 正确
emit('add'); // 错误,未声明 'add' 事件

5、避免滥用事件

在设计组件时,尽量减少事件的种类和数量,尤其是在组件树较为复杂时。过多的事件可能导致代码难以维护和调试。

到此这篇关于Vue3中emit使用的文章就介绍到这了,更多相关Vue3中emit使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • VUE中如何实现阻止事件冒泡

    VUE中如何实现阻止事件冒泡

    这篇文章主要介绍了VUE中如何实现阻止事件冒泡,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-08-08
  • vue 重塑数组之修改数组指定index的值操作

    vue 重塑数组之修改数组指定index的值操作

    这篇文章主要介绍了vue 重塑数组之修改数组指定index的值操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-08-08
  • 7个适用于Vue 3的高颜值UI组件库

    7个适用于Vue 3的高颜值UI组件库

    这篇文章主要给大家分享介绍了7个适用于Vue 3的高颜值UI组件库,合理利用,又或者学习借鉴都是不错的选择,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2022-12-12
  • 浅谈VUE单页应用首屏加载速度优化方案

    浅谈VUE单页应用首屏加载速度优化方案

    这篇文章主要介绍了浅谈VUE单页应用首屏加载速度优化方案,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-08-08
  • Vue 子组件使用 this.$parent 无法访问到父组件数据和方法(解决思路)

    Vue 子组件使用 this.$parent 无法访问到父组件数据和方法(解决思路)

    这篇文章主要介绍了Vue 子组件使用 this.$parent 无法访问到父组件数据和方法,解决思路也很简单,本文结合实例代码给大家介绍的非常详细,需要的朋友可以参考下
    2023-07-07
  • vue3+elementPlus table中添加输入框并提交校验

    vue3+elementPlus table中添加输入框并提交校验

    这篇文章主要介绍了vue3+elementPlus table里添加输入框并提交校验,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-08-08
  • 解决vue2.0 element-ui中el-upload的before-upload方法返回false时submit()不生效问题

    解决vue2.0 element-ui中el-upload的before-upload方法返回false时submit(

    这篇文章主要介绍了vue2.0 element-ui中el-upload的before-upload方法返回false时submit()不生效的解决方法,这里需要主要项目中用的element-ui是V1.4.3,感兴趣的朋友参考下吧
    2018-08-08
  • vue2封装webSocket的实现(开箱即用)

    vue2封装webSocket的实现(开箱即用)

    在Vue2中,可以使用WebSocket实时通信,本文主要介绍了vue2封装webSocket的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-08-08
  • Vue如何实现利用vuex永久储存数据

    Vue如何实现利用vuex永久储存数据

    这篇文章主要介绍了Vue如何实现利用vuex永久储存数据问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-04-04
  • Vue中的字符串模板的使用

    Vue中的字符串模板的使用

    本篇文章主要介绍了Vue中的字符串模板的使用,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-05-05

最新评论