vue .sync 和 v-model 区别

在Vue.js中,.sync修饰符和v-model都用于实现双向数据绑定,但它们在应用场景和实现方式上有显著区别:

1. 核心用途

  • v-model
    主要用于表单元素自定义组件单一数据双向绑定 。默认绑定value属性和input事件(可配置为其他属性和事件)。
  • .sync
    用于多个props的双向绑定 。通过触发update:propName事件更新父组件的值,适合需要同步多个props的场景。

2. 语法实现

  • v-model

    语法糖,等价于绑定value属性和监听input事件:

    vue 复制代码
    <child :value="data" @input="data = $event" />

    自定义组件可通过model选项修改默认行为:

    javascript 复制代码
    model: { prop: 'checked', event: 'change' }
  • .sync

    语法糖,等价于绑定属性和监听update:propName事件:

    vue 复制代码
    <child :title="pageTitle" @update:title="pageTitle = $event" />

3. 数量限制

  • v-model
    在Vue 2中,一个组件只能有一个v-model

  • .sync
    支持多个props的双向绑定 ,例如:

    vue 复制代码
    <child :name.sync="userName" :age.sync="userAge" />

4. Vue 3中的变化

  • v-model
    支持参数化绑定 ,替代.sync的功能,例如:

    vue 复制代码
    <child v-model:name="userName" v-model:age="userAge" />

    Vue 3中不再推荐使用.sync,转而用带参数的v-model

5. 使用场景

  • v-model
    适用于核心数据绑定(如输入框、开关状态等)。
  • .sync
    适用于需要同步多个props的场景(如弹窗组件的多个配置参数)。

示例对比

  • v-model(Vue 2)

    父组件:

    vue 复制代码
    <CustomInput v-model="message" />

    子组件通过value接收值,触发input事件更新:

    javascript 复制代码
    this.$emit('input', newValue);
  • .sync(Vue 2)

    父组件:

    vue 复制代码
    <Child :title.sync="pageTitle" />

    子组件触发update:title事件:

    javascript 复制代码
    this.$emit('update:title', newTitle);

总结

特性 v-model .sync
绑定数量 单个 多个
默认绑定 valueinput事件 propupdate:prop事件
Vue 2场景 核心数据绑定 多props同步
Vue 3替代方案 支持参数化(替代.sync 废弃,改用带参数的v-model

在Vue 2中,根据需求选择:单一核心数据用v-model,多props同步用.sync;在Vue 3中,统一使用参数化的v-model

相关推荐
Hilaku8 分钟前
我用 Gemini 3 Pro 手搓了一个并发邮件群发神器(附源码)
前端·javascript·github
IT_陈寒8 分钟前
Java性能调优实战:5个被低估却提升30%效率的JVM参数
前端·人工智能·后端
快手技术9 分钟前
AAAI 2026|全面发力!快手斩获 3 篇 Oral,12 篇论文入选!
前端·后端·算法
颜酱11 分钟前
前端算法必备:滑动窗口从入门到很熟练(最长/最短/计数三大类型)
前端·后端·算法
全栈前端老曹19 分钟前
【包管理】npm init 项目名后底层发生了什么的完整逻辑
前端·javascript·npm·node.js·json·包管理·底层原理
HHHHHY25 分钟前
mathjs简单实现一个数学计算公式及校验组件
前端·javascript·vue.js
boooooooom28 分钟前
Vue3 provide/inject 跨层级通信:最佳实践与避坑指南
前端·vue.js
一颗烂土豆28 分钟前
Vue 3 + Three.js 打造轻量级 3D 图表库 —— chart3
前端·vue.js·数据可视化
青莲84329 分钟前
Android 动画机制完整详解
android·前端·面试
iReachers32 分钟前
HTML打包APK(安卓APP)中下载功能常见问题和详细介绍
前端·javascript·html·html打包apk·网页打包app·下载功能