Vue 3 封装带输入框的自定义表单控件应基于 defineModel 实现 v-model 双向绑定,透传 $attrs 支持原生属性,显式声明并绑定 blur/focus/change 等事件,结合 CSS Modules 和 props 控制样式与主题适配。

Vue 3 封装带输入框的自定义表单控件,核心是让组件支持 v-model,同时兼顾可配置性、样式隔离和事件透传。不需要从零写 props + emits 的流水账,尤其在 Vue 3.4+ 可直接用 defineModel 简化逻辑。
基础结构:用 defineModel 实现双向绑定
替代旧版手写 modelValue prop 和 update:modelValue emit,一行代码搞定绑定逻辑:
- 子组件中声明:
const model = defineModel({ type: String, default: '' }); - 模板中直接绑定:
- 父组件使用:
,语义清晰,无额外事件监听
支持属性透传与原生 input 特性
用户可能需要传 placeholder、disabled、type 等原生属性,不建议全量定义 props,而是用 v-bind="$attrs" 透传:
- 在
标签上加v-bind="$attrs" - 确保组件启用
inheritAttrs: false(script setup下默认已关闭) - 这样
会自动生效,无需额外处理
暴露常用事件并保持语义一致性
除了 v-model,实际业务中常需监听 blur、focus、change 等事件:
- 用
defineEmits显式声明:const emit = defineEmits(['blur', 'focus', 'change']); - 在 input 上绑定:
@blur="emit('blur', $event)",避免事件被$attrs意外捕获 - 若需兼容表单校验(如 Element Plus),可同步触发
validate或提供validateEvent控制是否触发校验
样式封装与主题适配
避免全局污染,推荐组合使用 CSS Modules 和内联 class:
- 用
定义局部样式,如:global(.el-input__inner)可穿透覆盖第三方库样式 - 通过
props暴露size、clearable等开关,配合条件 class 控制外观 - 如需深色模式适配,可监听
prefers-color-scheme或读取父级提供的 theme 注入
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










