父子间通信之defineEmits详解+v-model 用于父子间通信原理+defineModel最新语法
欢迎来到我的博客!
使用 Markdown 格式编写。
今天学到了什么
- defineEmits
- $emit
- v-model
- defineModel
子组件 Counter.vue
<script setup lang="ts">defineProps<{ count: number }>()const emit = defineEmits<{ (e: 'update:count', value: number): void }>()</script>
<template> <button @click="emit('update:count', count + 1)">+1</button> <p>{{ count }}</p></template>父组件:
<script setup lang="ts">import { ref } from 'vue'import Counter from './Counter.vue'
const num = ref(0)</script>
<template> <!-- 完整写法 --> <Counter :count="num" @update:count="num = $event" />
<!-- 语法糖简写(效果完全一样) --> <Counter v-model:count="num" /></template> =“num是什么
:count="num" 拆开来看,就是把父组件的变量 num 动态绑定到子组件的 count 这个 prop 上。
逐个拆解
| 部分 | 含义 |
|---|---|
: | v-bind: 的缩写,意思是”这是一个变量,不是字符串” |
count | 子组件 defineProps 里声明的 prop 名字 |
num | 父组件 script 里定义的变量(ref(0)) |
合在一起就是:把父组件的 num 的值,传给子组件的 count。
加不加 : 的区别(非常容易踩坑)
<!-- 加冒号:传变量 num 的值(比如 0) --><Counter :count="num" /> <!-- 子组件收到的是数字 0 -->
<!-- 不加冒号:传纯字符串 "num" --><Counter count="num" /> <!-- 子组件收到的是字符串 "num" -->: 的作用就是告诉 Vue:等号右边是一段 JavaScript 表达式,请计算它的值再传过去,而不是直接当字符串传。
放在完整上下文里看
<!-- 完整写法:父传子 + 子通知父 --><Counter :count="num" @update:count="num = $event" />
<!-- 上面两句话合起来 = 下面这一句 --><Counter v-model:count="num" />:count="num" 只是单向的「父传子」。它只负责把数据送下去,不负责接收子组件的修改。所以必须搭配 @update:count 才能实现双向绑定。
简单比喻:
:count="num"→ 父组件把信寄给子组件@update:count="num = $event"→ 子组件回信,父组件拆开读
”num = $event这是什么?
$event 是 Vue 模板里的一个特殊变量,代表子组件 emit 传过来的那个参数值。
直白解释
回到刚才的代码:
// 子组件抛事件时,带了参数 1emit('update:count', 1)父组件这边收到事件,触发回调:
@update:count="num = $event"这里的 $event 就是子组件传过来的那个 1。
所以上面那句等价于执行:
num = 1为什么叫 $event?
这是 Vue 约定好的内置变量名(带 $ 前缀的都是 Vue 内置的,比如 $ref、$el)。它永远代表事件的第一个参数。
对比一下你就懂了
<!-- 原生点击事件 --><button @click="num = $event">点我</button><!-- 这里的 $event 是 MouseEvent 对象 -->
<!-- 自定义组件事件 --><Counter @update:count="num = $event" /><!-- 这里的 $event 是子组件 emit 传来的第二个参数 -->原生 DOM 事件的 $event 是浏览器的事件对象;自定义组件事件的 $event 就是 emit 的第二个参数。
不用 $event 的写法
如果不用简写,你可以写一个完整函数:
<Counter @update:count="handleChange" />
<script setup lang="ts">function handleChange(value: number) { num.value = value // value 就是 $event 的内容}</script>num = $event 只是把”接收 → 赋值”一步到位写在了模板里。
类比理解
// 伪代码:Vue 底层帮你做了这件事子组件.emit('update:count', 1) ↓父组件接收到 → const $event = 1 → 执行 num = $event所以 $event 就是一个占位符,代表”子组件传上来的那个值”。
$event 在多个参数时怎么处理
如果子组件 emit 传过来不止一个参数,$event 的用法会有变化,分两种情况:
情况一:直接在模板里写行内代码(只能拿到第一个参数)
<!-- 子组件 --><script setup lang="ts">const emit = defineEmits<{ (e: 'user-update', name: string, age: number): void}>()
// 触发时传了两个参数emit('user-update', '张三', 25)</script>父组件用 $event 接收:
<!-- ⚠️ 注意:$event 永远只代表第一个参数 --><Child @user-update="handleUpdate($event)" />
<script setup lang="ts">function handleUpdate(name: string) { console.log(name) // "张三" // 年龄 25 丢了!}</script>如果想同时拿到多个参数,模板里必须显式声明形参:
<!-- 用箭头函数把参数一个个接住 --><Child @user-update="(name, age) => handleUpdate(name, age)" /><!-- 也可以简写成 --><Child @user-update="(...args) => handleUpdate(...args)" />
<script setup lang="ts">function handleUpdate(name: string, age: number) { console.log(name, age) // "张三" 25 ✅ 两个都拿到了}</script>情况二:传给一个处理函数(推荐,更清晰)
不写行内代码,直接把函数名挂上去:
<Child @user-update="handleUpdate" />
<script setup lang="ts">// Vue 会自动把所有参数按顺序传进来function handleUpdate(name: string, age: number) { console.log(name, age) // "张三" 25 ✅}</script>这是最推荐的写法,不用管 $event,也不用写箭头函数,Vue 自动把 emit 的所有参数按顺序塞进函数形参里。
一句话总结
| 写法 | 能拿到几个参数 |
|---|---|
@event="fn($event)" | 只能拿第一个 |
@event="(a, b) => fn(a, b)" | 全部都能拿 |
@event="fn" | 全部都能拿(最省事)✅ |
点击按钮之后的执行流程

第 1 步:按钮被点击,执行 @click
子组件监听到点击事件,开始执行括号里的代码:emit('update:count', count + 1)
第 2 步:子组件向外“喊话”(派发事件)
子组件通过 emit 向它的上一级(也就是父组件)发送了一个自定义事件:
- 事件名:
update:count - 携带的数据:
0 + 1 = 1
第 3 步:父组件“听到”并修改数据
因为父组件使用了语法糖 <Counter v-model:count="num" />,Vue 在底层会自动把它翻译成:<Counter :count="num" @update:count="num = $event" />
所以,当父组件收到 update:count 事件时,它会把接收到的数据 1 赋值给自己的变量 num。此时,num 的值从 0 变成了 1。
第 4 步:Vue 响应式系统开始更新(自上而下)
因为 num 是 ref 响应式变量,它的值发生变化后,Vue 会触发重新渲染:
- 父组件重新渲染,发现
num变成了1。 - 父组件将最新的值
1通过 props 传递给子组件。
第 5 步:子组件视图更新
子组件接收到新的 count 值(1),触发自身的视图更新:页面上的 <p>{{ count }}</p> 里的 0 被替换成了 1。
总结这一圈的“数据旅行”:
用户点击 ➔ 子组件算出 1 并抛出 ➔ 父组件接收 1 并修改 num ➔ 父组件把新的 1 传回给子组件 ➔ 页面数字变成 1。
这就是 Vue 3 中单向数据流最经典的闭环。
$emit和defineEmit
这是个好问题!因为 $emit 是 Vue 组件实例的内置方法,它天生就存在,不需要声明也能用。
为什么能触发?
Vue 3 的运行机制是:模板里的 $emit 最终会被编译成 emit() 函数调用。即使你没有用 defineEmits 声明,Vue 在运行时照样能把事件抛出去,父组件照样能收到。
简单说:defineEmits 是编译时的类型声明,不是运行时的开关。
那为什么还要写 defineEmits?
| 不写 defineEmits | 写了 defineEmits |
|---|---|
| 事件照样能触发 ✅ | 事件照样能触发 ✅ |
| TS 不检查事件名,写错不报错 ❌ | TS 会检查,写错名字直接红线 ❌ |
| 没有智能提示 | 有自动补全和参数提示 |
| 别人看你代码不知道你抛了哪些事件 | 一目了然,相当于文档 |
举个例子
// 没写 defineEmits$emit('updata:num', num + 1) // ← "update" 拼错了,TS 不报错,但父组件收不到!补上 defineEmits 后:
const emit = defineEmits<{ (e: 'update:num', value: number): void}>()
// 现在如果拼错:$emit('updata:num', num + 1) // ← TS 直接报红:"updata:num" 不存在一句话总结
defineEmits就像 TypeScript 里的类型注解——不写能跑,写了更安全。
建议还是加上,花一行代码的功夫,换来类型安全和智能提示,值!
注意:
$emit / defineEmits 只能用于子组件通知直接父组件,不能直接用于子孙之间、兄弟之间、任意组件之间。
它的本质是:子组件触发一个自定义事件,只有监听这个事件的父组件能收到。如果中间隔了一层组件,父组件不转发,孙子组件就收不到。
v-model怎么用于父子间通信+defineModel最新语法
在 Vue 3 中,v-model 用于父子组件通信的核心逻辑是:父组件通过 v-model 绑定数据,子组件通过 props 接收数据,并通过触发 update
下面我为你拆解具体的用法:
1. 基础用法(默认模型)
这是最常见的情况,通常用于表单组件或自定义输入框。
**父组件 (Parent.vue)**父组件使用 v-model 绑定一个变量。
<template> <!-- v-model 默认绑定 modelValue --> <ChildComponent v-model="parentMessage" /> <p>父组件接收到的值:{{ parentMessage }}</p></template>
<script setup>import { ref } from 'vue';import ChildComponent from './ChildComponent.vue';
const parentMessage = ref('Hello');</script>**子组件 (ChildComponent.vue)**子组件需要定义 modelValue prop,并在需要更新时触发 update:modelValue 事件。
<template> <input :value="modelValue" @input="$emit('update:modelValue', $event.target.value)" /></template>
<script setup>// 1. 定义 props 接收 modelValuedefineProps(['modelValue']);
// 2. 定义 emits 声明更新事件defineEmits(['update:modelValue']);</script>2. 多个 v-model 绑定
Vue 3 允许在一个组件上使用多个 v-model,这需要给它们指定不同的参数名。
父组件 (Parent.vue)
<template> <!-- 指定参数名 title 和 content --> <ChildComponent v-model:title="bookTitle" v-model:content="bookContent" /></template>
<script setup>import { ref } from 'vue';import ChildComponent from './ChildComponent.vue';
const bookTitle = ref('Vue 3 实战');const bookContent = ref('这是内容...');</script>子组件 (ChildComponent.vue)
<template> <div> <input :value="title" @input="$emit('update:title', $event.target.value)" /> <textarea :value="content" @input="$emit('update:content', $event.target.value)" /> </div></template>
<script setup>// 接收多个 propdefineProps(['title', 'content']);
// 声明多个 update 事件defineEmits(['update:title', 'update:content']);</script>3. 使用 defineModel (Vue 3.4+ 推荐写法)
如果你使用的是 Vue 3.4 或更高版本,官方推出了 defineModel 宏,这让代码变得极其简洁,不再需要手动写 props 和 emits。
**父组件 (Parent.vue)**代码保持不变:
<ChildComponent v-model="count" />**子组件 (ChildComponent.vue)**直接使用 defineModel 获取一个双向绑定的 ref。
<template> <button @click="modelValue++"> 当前计数: {{ modelValue }} </button></template>
<script setup>// 直接获取一个 ref,读写它都会自动同步到父组件const modelValue = defineModel();</script>如果是多个 v-model:
const title = defineModel('title');const content = defineModel('content');总结
- 传统写法:父组件
v-model="data"-> 子组件props: ['modelValue']+emit('update:modelValue')。 - 新式写法 (Vue 3.4+):子组件直接使用
const model = defineModel(),就像操作普通的ref一样简单。
建议在学习和做项目时,如果是新项目,优先尝试使用 defineModel,它能大幅减少样板代码。
赞助支持
如果这篇文章对你有帮助,欢迎赞助支持!
部分内容可能已过时