Vue自定义表单组件必须声明emits:['update:modelValue'],将modelValue传给:value,并在原生事件中emit('update:modelValue', newValue),不可用v-model绑定内部input或修改props。

Vue 自定义表单组件要通过 update:modelValue 正确派发更新,核心是遵守 Vue 3 的 v-model 协议:接收 modelValue prop,并在值变化时显式触发 update:modelValue 事件。这不是可选行为,而是框架约定的通信契约。
必须声明 emits 并正确触发事件
子组件需明确告诉 Vue:“我能发出这个事件”。否则即使调用了 emit,父组件也无法响应 v-model 绑定。
- 使用
defineEmits(['update:modelValue'])声明可触发事件(组合式 API) - 在用户交互(如输入、选择、点击)后调用
emit('update:modelValue', newValue) - 不要写成
emit('input', ...)或emit('change', ...),这些不会被 v-model 自动识别
绑定 input 元素的 value 和监听原生事件
v-model 在底层依赖原生表单控件的行为,所以自定义组件内部通常需要桥接原生元素。
- 把
modelValue传给原生<input>的:value属性(不能用v-model,否则会形成循环) - 监听原生
@input(文本类)、@change(select/checkbox)、@click(开关类)等事件 - 在事件处理器中提取新值,再通过
emit向上通知
注意值类型与修饰符兼容性
.number、.trim 等修饰符由父组件的 v-model 指令自动处理,但前提是子组件派发的值能被正确接收和转换。
立即学习“前端免费学习笔记(深入)”;
- 如果父组件写了
v-model.number,Vue 会在触发update:modelValue后自动对$event调用parseFloat() - 子组件无需自己做
Number()转换,除非你希望提前校验或过滤 - 但要注意:如果子组件 emit 的是字符串
'123',父组件绑定v-model.number就能得到数字123;如果 emit 的是空字符串'',parseFloat('')返回NaN,这是预期行为
避免常见错误写法
这些写法看似合理,实际会破坏双向绑定逻辑:
- props 写成
value(Vue 3 不再识别,v-model 会静默失效) - emits 写成
['input']或漏写emits选项(开发模式下有警告,生产环境无响应) - 在
@input里直接改props.modelValue(props 是只读的,会报错) - 用
v-model直接绑定内部<input>(导致父子值不同步,且可能触发无限循环)


















