vue3 双向绑定:如何在自定义组件中修改props定义的属性值,并更新父组件绑定的响应式变量值

1、自定义支持双向绑定的prop

在子组件中声明一个 count prop,通过触发 update:count 事件更新父组件值

子组件示例代码:

html 复制代码
<template>
    <div>
        <div>[子组件] count: {{ count }}</div>
        <button @click="onClick">+1</button>
    </div>
</template>

<script lang="ts">
import { defineComponent } from 'vue';
export default defineComponent({
    name: 'child-component',
    props: {
        count: {
            type: Number,
            default: 0
        }
    },
    emits: ['update:count'],
    setup(props, ctx) {
        const onClick = () => {
            ctx.emit('update:count', props.count + 1);
        }
        return {
            onClick
        };
    }
});
</script>

父组件示例代码:

html 复制代码
<template>
    <div>
        <div>[父组件] count: {{ count }}</div>
        <child-component :count="count" @update:count="count = $event"></child-component>
    </div>
</template>

<script lang="ts">
import ChildComponent from '@/components/child-component/child-component.vue';
import { defineComponent, ref } from 'vue';
export default defineComponent({
    components: { ChildComponent },
    setup() {
        return {
            count: ref<number>(0)
        };
    }
});
</script>

简化写法(语法糖),使用 v-model 双向数据绑定的指令

html 复制代码
<child-component v-model:count="count"></child-component>

2、子组件 prop 为 modelValue

在子组件中声明一个 modelValueprop,通过触发 update:modelValue 事件更新父组件值,父组件使用 v-model 、 v-model:modelValue 、 v-model:model-value 的写法都是支持的。

子组件示例代码:

TypeScript 复制代码
<script setup lang="ts">
  defineProps(['modelValue'])
</script>

<template>
  <el-input :modelValue="modelValue" @input="$emit('update:modelValue', $event)"/>
</template>

父组件示例代码:

TypeScript 复制代码
<script setup lang="ts">
import { ref } from 'vue'
import ChildComponent from './components/ChildComponent.vue'

const parentValue = ref('')
</script>

<template>
  <ChildComponent v-model="parentValue" />
</template>

其他支持写法:

TypeScript 复制代码
<ChildComponent v-model:modelValue="parentValue" />
<ChildComponent v-model:model-value="parentValue" />
<ChildComponent :modelValue="parentValue" @update:modelValue="parentValue = $event" />
<ChildComponent :model-value="parentValue" @update:model-value="parentValue = $event" />

3、子组件中也存在组件v-model 的值需与 prop 的值同步

定义一个可写的 computed 响应式变量,get直接返回传入子组件的 prop,set变更 prop 的值

TypeScript 复制代码
<script setup lang="ts">
  import { computed } from 'vue'

  const props = defineProps(['modelValue'])

  const emits = defineEmits(['update:modelValue'])

  const childValue = computed({
    get: () => props.modelValue,
    set: (val) => emits('update:modelValue', val)
  })
</script>

<template>
  <el-input v-model="childValue"/>
</template>

4、vue3.4+ 推荐使用 defineModel

写法更加简单,关于默认值、必填等选项配置可查阅文档

官方文档:https://cn.vuejs.org/api/sfc-script-setup.html#definemodel

子组件示例代码:

TypeScript 复制代码
<script setup lang="ts">
  const modelValue = defineModel()
</script>

<template>
  <el-input v-model="modelValue" />
</template>
相关推荐
LaoZhangAI4 分钟前
【2025最新】Claude免费API完全指南:无需信用卡,中国用户也能用
前端
cypking10 分钟前
解决 axios get请求瞎转义问题
vue.js
向阳25619 分钟前
SpringBoot+vue前后端分离整合sa-token(无cookie登录态 & 详细的登录流程)
java·vue.js·spring boot·后端·sa-token·springboot·登录流程
hepherd22 分钟前
Flask学习笔记 - 模板渲染
前端·flask
LaoZhangAI22 分钟前
【2025最新】Manus邀请码免费获取完全指南:5种稳定渠道+3个隐藏方法
前端
经常见24 分钟前
浅拷贝与深拷贝
前端
艾克马斯奎普特25 分钟前
Vue.js 3 渐进式实现之响应式系统——第一节:系列开篇与响应式基本实现
vue.js
梅子酱~28 分钟前
Vue 学习随笔系列二十二 —— 表格高度自适应
javascript·vue.js·学习
前端飞天猪29 分钟前
学习笔记:三行命令,免费申请https加密证书📃
前端
关二哥拉二胡30 分钟前
前端的 AI 应用开发系列二:手把手揭秘 RAG
前端·面试