Vue 中父子组件之间最常用的业务交互场景

 更新时间:2026年03月06日 10:05:02   作者:萧曵 丶  
本文主要介绍了Vue 中父子组件之间最常用的业务交互场景,包括Props传递数据、$emit触发事件、ref调用方法、自定义v-model双向绑定及避免使用$parent的建议,感兴趣的可以了解一下

Vue 父子组件的核心交互逻辑围绕「数据向下传递、事件向上触发」展开,以下是实际业务中最常用的 5 类场景,均基于 Vue3 组合式 API(主流用法)演示:

场景 1:父组件向子组件传递数据(Props)

业务场景:父组件加载列表数据,子组件负责展示单条数据(如商品卡片、用户信息项)。

父组件(Parent.vue)

<template>
  <div class="parent">
    <h3>父组件</h3>
    <!-- 向子组件传递商品数据 -->
    <Child :product="productInfo" />
  </div>
</template>

<script setup>
import Child from './Child.vue'
// 父组件的数据源
const productInfo = {
  id: 1001,
  name: "Vue实战教程",
  price: 99,
  stock: 200
}
</script>

子组件(Child.vue)

<template>
  <div class="child">
    <h4>子组件 - 商品展示</h4>
    <p>商品ID:{{ product.id }}</p>
    <p>商品名称:{{ product.name }}</p>
    <p>商品价格:¥{{ product.price }}</p>
  </div>
</template>

<script setup>
// 接收父组件传递的props,指定类型(增强健壮性)
const props = defineProps({
  product: {
    type: Object,
    required: true, // 必传项
    default: () => ({}) // 默认值(防止未传时报错)
  }
})
</script>

关键说明

  • defineProps 是 Vue3 组合式 API 的内置方法,无需导入即可使用;
  • Props 支持类型校验(String/Number/Object/Array 等),推荐显式声明,便于维护;
  • Props 是单向数据流,子组件不能直接修改父组件传递的 props(需通过事件通知父组件修改)。

场景 2:子组件向父组件传递数据 / 触发事件($emit)

业务场景:子组件的按钮点击、表单提交等操作,需要通知父组件处理(如子组件点击「减库存」按钮,父组件更新库存数据)。

父组件(Parent.vue)

<template>
  <div class="parent">
    <h3>父组件 - 库存:{{ productInfo.stock }}</h3>
    <!-- 监听子组件触发的reduceStock事件 -->
    <Child 
      :product="productInfo" 
      @reduce-stock="handleReduceStock"
    />
  </div>
</template>

<script setup>
import Child from './Child.vue'
import { ref } from 'vue'
// 改用ref声明响应式数据(便于修改)
const productInfo = ref({
  id: 1001,
  name: "Vue实战教程",
  price: 99,
  stock: 200
})

// 处理子组件触发的减库存事件
const handleReduceStock = (num) => {
  if (productInfo.value.stock > 0) {
    productInfo.value.stock -= num
  } else {
    alert('库存不足!')
  }
}
</script>

子组件(Child.vue)

<template>
  <div class="child">
    <h4>子组件 - 操作区</h4>
    <!-- 点击按钮触发自定义事件,传递参数1 -->
    <button @click="handleClick">减少1件库存</button>
  </div>
</template>

<script setup>
// 定义子组件可触发的事件
const emit = defineEmits(['reduce-stock'])

// 点击按钮时,向父组件触发事件并传递参数
const handleClick = () => {
  emit('reduce-stock', 1) // 事件名 + 传递的参数
}
</script>

关键说明

  • defineEmits 用于声明子组件可触发的事件,支持数组 / 对象形式(对象可做参数校验);
  • 事件名推荐使用kebab-case(短横线命名),与模板中的监听格式一致;
  • 子组件可通过emit传递任意类型的参数(数字、对象、数组等)。

场景 3:父组件调用子组件的方法(ref)

业务场景:父组件点击按钮,触发子组件的内部方法(如子组件的表单重置、数据刷新、弹窗关闭)。

父组件(Parent.vue)

<template>
  <div class="parent">
    <h3>父组件</h3>
    <button @click="callChildMethod">调用子组件的方法</button>
    <!-- 给子组件绑定ref标识 -->
    <Child ref="childRef" />
  </div>
</template>

<script setup>
import Child from './Child.vue'
import { ref } from 'vue'

// 定义ref引用子组件实例
const childRef = ref(null)

// 父组件调用子组件方法
const callChildMethod = () => {
  // 通过ref访问子组件暴露的方法
  childRef.value.resetForm()
}
</script>

子组件(Child.vue)

<template>
  <div class="child">
    <h4>子组件 - 表单区域</h4>
    <input v-model="inputValue" placeholder="请输入内容" />
  </div>
</template>

<script setup>
import { ref } from 'vue'

const inputValue = ref('')

// 子组件的内部方法
const resetForm = () => {
  inputValue.value = ''
  alert('子组件表单已重置!')
}

// 暴露方法给父组件调用(关键)
defineExpose({
  resetForm
})
</script>

关键说明

  • 父组件通过ref绑定子组件,获取子组件实例;
  • 子组件需通过defineExpose显式暴露方法 / 数据,父组件才能访问(Vue3 默认隐藏子组件内部属性);
  • 适用于「父组件主动控制子组件行为」的场景,避免过度使用(优先用 props/emit)。

场景 4:父子组件双向绑定(自定义 v-model)

业务场景:自定义表单组件(如输入框、开关、下拉框),需要和父组件的数据双向同步(Vue2 的.sync语法在 Vue3 中已整合为 v-model)。

父组件(Parent.vue)

<template>
  <div class="parent">
    <h3>父组件 - 双向绑定值:{{ inputValue }}</h3>
    <!-- 自定义v-model绑定 -->
    <Child v-model="inputValue" />
  </div>
</template>

<script setup>
import Child from './Child.vue'
import { ref } from 'vue'

// 父组件双向绑定的数据源
const inputValue = ref('初始值')
</script>

子组件(Child.vue)

<template>
  <div class="child">
    <h4>子组件 - 自定义输入框</h4>
    <!-- 输入框值变化时,触发update:modelValue事件 -->
    <input 
      :value="modelValue" 
      @input="emit('update:modelValue', $event.target.value)"
    />
  </div>
</template>

<script setup>
// 接收v-model的默认props(modelValue)
const props = defineProps(['modelValue'])
// 定义更新事件(update:modelValue是固定命名)
const emit = defineEmits(['update:modelValue'])
</script>

进阶:自定义 v-model 名称如果需要多个双向绑定,可自定义 v-model 的名称:

<!-- 父组件 -->
<Child v-model:username="username" v-model:phone="phone" />

<!-- 子组件 -->
<script setup>
const props = defineProps(['username', 'phone'])
const emit = defineEmits(['update:username', 'update:phone'])
</script>

场景 5:子组件访问父组件($parent,不推荐)

说明:Vue 官方不推荐直接使用$parent访问父组件(破坏组件封装性),仅作了解,优先用 props/emit。

<!-- 子组件中 -->
<script setup>
import { getCurrentInstance } from 'vue'

// 获取组件实例
const instance = getCurrentInstance()
// 访问父组件数据/方法
console.log(instance.parent.proxy.productInfo)
</script>

总结

  1. 核心交互规则:父传子用props(单向数据流),子传父用emit(事件触发),这是 Vue 父子组件通信的最佳实践;
  2. 父调子方法:通过ref + defineExpose实现,适用于父组件主动控制子组件行为的场景;
  3. 双向绑定:Vue3 通过自定义v-modelmodelValue + update:modelValue)实现,替代 Vue2 的.sync语法;
  4. 避免直接使用$parent/$children,会降低组件的独立性和可维护性。

到此这篇关于Vue 中父子组件之间最常用的业务交互场景的文章就介绍到这了,更多相关Vue 父子组件交互内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 详解VUE响应式原理

    详解VUE响应式原理

    这篇文章主要为大家介绍了vue组件通信的几种方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2021-11-11
  • vue实现输入框自动跳转功能

    vue实现输入框自动跳转功能

    这篇文章主要为大家详细介绍了vue实现输入框自动跳转功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-05-05
  • vue实现对highlight-current-row方式整行选中后修改默认背景颜色

    vue实现对highlight-current-row方式整行选中后修改默认背景颜色

    这篇文章主要介绍了vue实现对highlight-current-row方式整行选中后修改默认背景颜色方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-11-11
  • vuex中使用modules时遇到的坑及问题

    vuex中使用modules时遇到的坑及问题

    这篇文章主要介绍了vuex中使用modules时遇到的坑及问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-08-08
  • webstorm问题解决:无法识别@处理方案

    webstorm问题解决:无法识别@处理方案

    在使用Vite和WebStorm时,如果`vite.config.ts`已经配置了路径别名`@`,但WebStorm无法识别,可以通过在项目根目录下创建`tsconfig.json`文件,并添加`baseUrl`和`paths`配置来解决,这样不仅可以让TypeScript正确解析路径别名,也能让WebStorm识别这些路径
    2026-01-01
  • Vue+ElementUI怎么处理超大表单实例讲解

    Vue+ElementUI怎么处理超大表单实例讲解

    在本篇文章里小编给大家整理的是一篇关于Vue+ElementUI怎么处理超大表单实例讲解内容,以后需要的朋友可以跟着学习参考下。
    2021-11-11
  • vue项目中进行svg组件封装及配置方法步骤

    vue项目中进行svg组件封装及配置方法步骤

    本文主要介绍了vue项目中进行svg组件封装及配置方法步骤,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-11-11
  • 简单理解Vue中的nextTick方法

    简单理解Vue中的nextTick方法

    本篇文章主要介绍了简单理解Vue中的nextTick方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • Vue中的Object.defineProperty全面理解

    Vue中的Object.defineProperty全面理解

    这篇文章主要介绍了Vue中的Object.defineProperty全面理解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • vue项目内存溢出问题及解决方案

    vue项目内存溢出问题及解决方案

    这篇文章主要介绍了vue项目内存溢出问题及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-01-01

最新评论