2541 字
13 分钟

父子间通信之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 传过来的那个参数值。

直白解释#

回到刚才的代码:

// 子组件抛事件时,带了参数 1
emit('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"全部都能拿(最省事)✅

点击按钮之后的执行流程#

79257318401

第 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 会触发重新渲染:

  1. 父组件重新渲染,发现 num 变成了 1。
  2. 父组件将最新的值 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 接收 modelValue
defineProps(['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>
// 接收多个 prop
defineProps(['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,它能大幅减少样板代码。


赞助支持

如果这篇文章对你有帮助,欢迎赞助支持!

赞助
父子间通信之defineEmits详解+v-model 用于父子间通信原理+defineModel最新语法
https://firefly.cuteleaf.cn/posts/study-everyday/2026-10-21今日学习-defineemits/
作者
LJC
发布于
2026-10-21
许可协议
CC BY-NC-SA 4.0
最后更新于 2026-10-21,距今已过 1 天

部分内容可能已过时

目录