Vue.js 中子组件 @emit 未被父组件捕获的解决方案

小伟大大_1554

小伟大大_1554

2026-05-01

963人浏览

原创

Vue.js 中子组件 @emit 未被父组件捕获的解决方案

Vue 3 默认要求显式声明子组件触发的自定义事件(emits),否则父组件无法监听;若未在子组件中声明 emits: ['newPicture'],即使调用 this.$emit('newPicture', ...) 也不会被父组件响应。

vue 3 默认要求显式声明子组件触发的自定义事件(`emits`),否则父组件无法监听;若未在子组件中声明 `emits: ['newpicture']`,即使调用 `this.$emit('newpicture', ...)` 也不会被父组件响应。

在 Vue 3 的 Options API 中,自定义事件必须显式声明,这是 Vue 3 引入的重要变更(区别于 Vue 2 的隐式支持)。你的 ImageUpload 子组件虽然正确调用了 this.$emit('newPicture', imageData),且控制台已输出 "klaar voor emit...?",但因未在组件选项中声明 emits,该事件会被 Vue 忽略——父组件自然收不到,updatePicture 回调也就不会执行。

✅ 正确做法:在子组件中声明 emits

请将以下代码添加到 ImageUpload.vue 的 export default 配置中(与 props、data、methods 同级):

export default {
  props: ['imgUrl'],
  emits: ['newPicture'], // ? 关键:显式声明可触发的事件名
  // ... 其余配置保持不变
}

? 注意:事件名需严格匹配(区分大小写),此处为 'newPicture',与模板中 @newPicture 和 $emit('newPicture') 完全一致。

? 验证是否生效

添加声明后重启开发服务器(或热更新生效),此时你将看到控制台输出:

emit ontvangen

同时 this.selectedFile 和 this.card.picture 将被正确赋值,后续 addCard() 方法中 formData.append('imagefile', this.selectedFile) 即可获取到裁剪后的文件对象。

vue-composition-api-best-practices
vue-composition-api-best-practices

Vue 3 组合式 API 与 <script setup> 最佳实践,涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。</p> </div> <a rel="nofollow" href="/xiazai/skill8748" title="vue-composition-api-best-practices" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div> <h3>⚠️ 补充注意事项</h3> <ul> <li><p><strong>Vue 版本确认</strong>:该行为仅适用于 Vue 3.x(Options API 或 Composition API 均适用)。若项目意外降级至 Vue 2,emits 选项不存在,但事件会默认透传——但你的代码使用了 defineEmits 示例,说明目标是 Vue 3。</p></li> <li> <p><strong>Composition API 用户</strong>:若改用 <script setup>,需配合 defineEmits:</script>

<script setup>
const emit = defineEmits(['newPicture'])

// 在 setImage() 中调用:
emit('newPicture', imageData)
</script>
  • 事件命名规范:推荐使用 kebab-case(如 'new-picture')以兼容 HTML 模板中的 @new-picture 绑定,但驼峰命名(newPicture)在 Options API 中也完全合法,前提是父子端保持一致。

  • 调试技巧:可在子组件 mounted 后打印 this.$options.emits,确认是否包含 'newPicture';也可在父组件中临时添加 @newPicture.capture="console.log" 查看是否捕获到事件。

  • ✅ 总结

    问题根源不是逻辑错误或异步时机问题,而是 Vue 3 的事件白名单机制所致。只需一行 emits: ['newPicture'] 声明,即可让 @newPicture 监听器正常工作。这是 Vue 3 提升类型安全与模板可维护性的重要设计,建议在所有自定义事件场景中主动声明。

    前端入门到VUE实战笔记:立即使用
    在学习笔记中,你将探索 前端 的入门与实战技巧!

    相关文章

    PHP速学视频免费教程(入门到精通)
    PHP速学视频免费教程(入门到精通)

    PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

    下载

    相关标签:

    vue js vue.js

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    js获取数组长度的方法
    js获取数组长度的方法

    在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

    2023.06.20

    4946

    5

    js刷新当前页面
    js刷新当前页面

    js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

    2023.07.04

    1229

    3

    js四舍五入
    js四舍五入

    js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

    2023.07.04

    4864

    6

    js删除节点的方法
    js删除节点的方法

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

    2023.09.01

    960

    4

    JavaScript转义字符
    JavaScript转义字符

    JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

    2023.09.04

    1876

    5

    js生成随机数的方法
    js生成随机数的方法

    js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

    2023.09.04

    3505

    4

    如何启用JavaScript
    如何启用JavaScript

    JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

    2023.09.12

    4533

    6

    Js中Symbol类详解
    Js中Symbol类详解

    javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

    2023.09.20

    2980

    5

    java访问控制修饰符介绍
    java访问控制修饰符介绍

    java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

    2023.09.20

    948

    7

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    uni-app快速上手
    uni-app快速上手

    共0课时 | 0人学习

    Vue 教程
    Vue 教程

    共42课时 | 17.1万人学习

    Vue3.x 工具篇--十天技能课堂
    Vue3.x 工具篇--十天技能课堂

    共26课时 | 2.5万人学习