Vue 自定义组件 v-model 与原生事件兼容-Vue.js-PHP中文网

Vue自定义组件中v-model与原生事件可共存，关键在于明确职责：v-model负责双向绑定（:modelValue + @update:modelValue），原生事件用于业务逻辑响应，二者互不干扰。

vue 自定义组件 v-model 与原生事件兼容

Vue 自定义组件要让 v-model 和原生事件（比如 @input、@blur、@change）同时正常工作，关键不是“避开冲突”，而是明确职责边界：v-model 负责数据同步，原生事件负责业务响应。只要不重复监听同一事件或覆盖默认行为，两者完全可以共存。

明确 v-model 的职责是双向绑定

v-model 在 Vue 3 中本质是语法糖，等价于：
:modelValue="xxx" + @update:modelValue="val => xxx = val"。
它只关心「值怎么进、怎么出」，不干涉其他交互逻辑。

组件内部必须用 :value="modelValue"（Vue 2 是 :value，Vue 3 是 :modelValue）绑定输入框
触发更新时只发 update:modelValue，不要额外 emit input 或覆盖原生事件
父组件传入的 v-model 值，应作为受控值使用，避免和本地 state 混用

原生事件该监听就监听，但别干扰 v-model 流程

你完全可以在组件里监听 @input、@blur 等事件做校验、上报、格式化，前提是：不阻止默认行为，也不手动修改 input 的 value。

例如需要实时格式化手机号，可在 @input 里处理字符串，但最终仍要通过 $emit('update:modelValue', formatted) 同步给父组件
如果监听了 @blur 并触发验证，验证失败可加 class 或弹提示，但不要 return 或 preventDefault —— 这不影响 v-model
避免在原生事件里直接赋值 this.modelValue = ...，这会破坏响应式链路

透传原生属性与事件最省心

对封装类组件（如基于 Element Plus 或 Ant Design 的二次封装），推荐用 v-bind="$attrs" 和 v-on="$listeners"（Vue 2）或 v-bind="$attrs"（Vue 3 默认已合并事件）自动继承所有未声明的 prop 和事件。

vue-composition-api-best-practices

Vue 3 组合式 API 与

相关专题

python是前端还是后端

Python属于前端也属于后端，其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容，供大家免费下载体验。

2523

2023.08.11

前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍：1、WebSocket，它可以在客户端和服务器之间建立持久连接，实现实时的双向通信，前端可以使用 WebSocket API来创建WebSocket连接，并通过发送和接收消息来实现即时通讯；2、Long Polling，是一种模拟实时通信的技术等等。

5463

2023.10.09

前端和后端的区别

前端关注的是用户界面的设计和交互，而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容，可以阅读本专题下面的文章。

6490

2024.03.19

php和前端的关联介绍

php既可以作为前端语言，也可以作为后端语言。想了解更多php和前端的相关内容，可以阅读本专题下面的文章。

6118

2024.03.22

前端外包工作内容有哪些

前端外包工作内容包括：1. 网站和应用程序开发；2. 用户界面和交互设计；3. 用户体验优化；4. 设计和视觉开发；5. 跨浏览器兼容性；6. 性能优化；7. 维护和更新；8. 项目管理和沟通。想了解更多前端的相关内容，可以阅读本专题下面的文章。

863

2024.05.22

vue2.0和3.0区别

vue2.0和3.0区别：vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现，vue3中使⽤了es6的proxy API对数据代理，实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容，供大家免费下载体验。

1694

2023.07.17

vue3的生命周期有哪些

vue3的生命周期：1、beforecreate；2、created；3、beforemount；4、mounted；5、beforeupdate；6、updated；7、beforedestroy；8、destroyed；9、activated；10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容，供大家免费下载体验。

12122

2024.02.23