$emit() 触发组件事件
最后更新:2026-10-22
$emit() 触发组件事件
$emit 触发自定义事件,参数原样传给父组件的监听函数,是子组件向父组件反馈的标准通道。
| 分组 | 选项式·组合与其他 |
|---|---|
| 类型 | 选项 |
| 作用域 | 组件内 |
| Vue 版本 | 3.0+ |
| SSR 支持 | 支持 |
📝 语法
export default {
methods: {
save() { this.$emit("save", { id: 1 }) }
}
}
⚙️ 参数
| value | 事件名 + 任意个载荷参数 |
|---|
返回值:无返回值
▶ 示例
修改下面的代码,在预览区实时查看效果:
输出:
点保存后显示 payload 里的 id。
💡 要点
ℹ️ 说明 声明在 emits 选项里可避免警告并获得工具提示。
💡 提示 命名建议 kebab-case(DOM 模板会强制小写)。
⚠️ 注意 事件名大小写敏感:@myEvent 在 DOM 模板里匹配不到 myEvent。
🏷️ 相关组合与其他
💡 相关案例
更多案例即将上线。
📚 相关教程
❓ 常见问题
Q 和父组件调子方法哪个好?
A emit 更好:保持单向数据流与解耦;ref 直调是应急手段。
Q 能传多个参数吗?
A 可以:$emit('change', a, b),处理函数 (a, b) => {}。
Q 父组件不监听会怎样?
A 事件被忽略,不报错。