Vue子组件通过$emit触发自定义事件实现子传父通信,父组件用v-on监听;Vue 3中需用defineEmits声明并调用emit函数,事件名推荐短横线格式且不可与原生事件同名。

在 Vue 组件中,子组件通过 $emit 主动触发自定义事件,让父组件监听并响应。这是 Vue 实现子传父通信的核心方式。
基本用法:定义并触发事件
子组件内部调用 this.$emit('事件名', 参数1, 参数2...) 即可向父组件抛出事件。事件名推荐使用短横线格式(如 'item-click'),避免和原生事件冲突,也更符合 HTML 规范。
- 不传参时:
this.$emit('update') - 传一个值:
this.$emit('change', newValue) - 传多个值:
this.$emit('submit', username, password)(注意:Vue 会把后续参数依次传递给父组件的事件处理器)
父组件如何监听和接收
父组件在使用子组件标签时,用 v-on(或简写 @)绑定对应事件名,并提供处理函数:
- 在父组件 methods 中定义:
handleItemClick(item) { console.log(item) } - 若子组件 emit 了多个参数,父组件方法形参顺序需与 emit 一致,如
@submit="onSubmit"对应onSubmit(username, password) {}
Vue 3 的 Composition API 写法(setup 中)
在 setup() 函数中,需显式声明 emit 函数:
- 先解构:
const emit = defineEmits(['update', 'delete']) - 再调用:
emit('update', { id: 1, name: 'Alice' }) - 注意:defineEmits 不参与响应式系统,也不需要 this;且必须在 setup 顶层调用
常见注意事项
- 事件名大小写敏感,且不能是原生事件名(如 click、input),否则可能被浏览器拦截或行为异常
- 父组件未监听该事件时,emit 不报错,但无任何效果——建议配合 TypeScript 或 emits 选项做校验
- Vue 3 推荐在组件选项中显式声明
emits: ['save', 'cancel'],提升可维护性和 IDE 支持
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











