Vue 3 组合式函数封装表单核心是抽离数据状态、验证逻辑、提交行为:用 reactive 管理 formValues 和 formErrors,ref 控制 isSubmitting,记录 dirtyFields;规则外置为 required、mobile 等工厂函数;提交分 validateBeforeSubmit、transformBeforeSubmit、handleSubmit 三阶段;深度协同 el-form,透传 props 并自动映射错误。

用 Vue 3 组合式函数封装表单校验与提交,核心是把“数据状态、验证逻辑、提交行为”三者抽离成可复用的逻辑单元,而不是在每个组件里重复写 ref、rules、el-form.validate()。关键不在于写得多,而在于配置驱动、规则集中、调用简洁。
定义统一的表单状态结构
一个表单至少要管理:字段值、错误信息、提交中状态、是否已触发表单校验。这些用 reactive 和 ref 封装进 useForm 函数里:
-
formValues:用
reactive管理所有字段值,支持嵌套和动态增删 -
formErrors:用
reactive存储各字段错误提示,便于el-form-item绑定error -
isSubmitting:用
ref控制按钮 loading 状态 - dirtyFields:记录哪些字段被用户修改过,用于区分“未填”和“填了错的”
校验规则外置 + 声明式调用
避免在每个表单里手写正则或 validator 函数。把常用规则提前定义为工厂函数:
-
required('用户名')→ 返回完整 rule 对象,含required: true和 message -
mobile('手机号')→ 内部用patterns.mobile正则,统一触发时机(blur) -
confirm('密码')→ 接收另一个字段名,自动比对值是否一致 - 规则可组合:
[required('邮箱'), email('邮箱')]直接传入字段配置
提交逻辑解耦 + 可中断流程
提交不是简单地 api.submit(formValues),而是分阶段可控:
- validateBeforeSubmit:先执行全部字段校验,失败则中断,不发请求
- transformBeforeSubmit:支持钩子,比如把日期转时间戳、过滤空字符串、拼接地址字段
- handleSubmit:接收一个异步提交函数,自动处理 loading、错误 toast、成功回调
- 返回对象包含
submit、reset、setValues、validateField等方法,按需使用
与 Element Plus el-form 深度协同
不是绕开 el-form,而是让它更省心:
- 通过
ref拿到el-form实例,内部调用validate/clearValidate - 把
formErrors映射到el-form-item :error,无需手动v-if判断 - 支持
label-width、size、inline等 props 透传,保持 UI 一致性 - 弹窗表单场景下,自动在
onBeforeUnmount清理 dirty 状态,防止下次打开残留红标
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










