Vue3 + Element Plus 表单校验踩坑:为什么我写的规则不生效?

Vue3 + Element Plus 表单校验踩坑:为什么我写的规则不生效?

大家好,我是一名前端开发,最近在做供应商管理后台的开发,遇到了一个非常基础但折腾了我很久的表单校验问题,今天把坑点和解决方法分享出来,帮大家少走弯路。

一、问题背景 我正在用 Vue3 + Element Plus 开发一个供应商信息新增表单,需求是: - 供应商名称必须填写 - 联系方式必须为手机号格式 我按照官方文档写好了校验规则,但点击提交时,表单明明是空的,却能直接提交,校验完全没触发。

二、错误的写法(踩坑现场)

一开始我是这么写的:

vue 复制代码
<template> 
<el-form :model="formData"> 
<el-form-item label="供应商名称" prop="supplierName"> 
<el-input v-model="formData.supplierName" /> 
</el-form-item> 
<el-button type="primary" @click="handleSubmit">提交</el-button> 
</el-form> 
</template> 
<script setup> 
import { reactive } from 'vue' 
const formData = reactive({ supplierName: '' }) 
const rules = { supplierName: [ { required: true, message: '请输入供应商名称', trigger: 'blur' } ] } 
const handleSubmit = () => { console.log('提交表单', formData) }
</script>


## 三、问题排查
遇到这个问题后,我一步步排查了原因: 
1. 首先检查了 `el-form-item` 的 `prop` 属性,和 `formData` 里的字段名完全对应,排除了拼写错误。 
2. 翻了 Element Plus 官方文档,发现我犯了一个低级错误:**没有给 `el-form` 绑定 `:rules` 属性**,组件根本不知道有校验规则。 
3. 另外,提交方法里也没有调用 `formRef.value.validate()`,无法手动触发校验,所以表单直接就提交了。

## 四、正确的写法(最终解决)
根据排查出的两个问题,我对代码做了修复,加上了 `:rules` 绑定和 `formRef` 手动校验,完整代码如下:
```vue 
<template>
<!-- 关键:给 el-form 绑定 :rules 和 ref -->
<el-form :model="formData" :rules="rules" ref="formRef" label-width="100px" > 
<el-form-item label="供应商名称" prop="supplierName">
<el-input v-model="formData.supplierName" placeholder="请输入供应商名称" /> 
</el-form-item> 
<el-form-item label="联系电话" prop="phone"> 
<el-input v-model="formData.phone" placeholder="请输入联系电话" /> 
</el-form-item> 
<el-form-item> 
<el-button type="primary" @click="handleSubmit">提交</el-button> 
</el-form-item>
</el-form> 
</template> 
<script setup> 
import { reactive, ref } from 'vue' 
// 表单数据 
const formData = reactive({ supplierName: '', phone: '' })
// 表单引用,用于手动触发校验 const formRef = ref(null) 
// 校验规则 
const rules = { supplierName: [ { required: true, message: '请输入供应商名称', trigger: 'blur' } ], 
phone: [ { required: true, message: '请输入联系电话', trigger: 'blur' }, { pattern: /^1[3-9]\d{9}$/, message: '手机号格式不正确', trigger: 'blur' } ] } 
// 提交方法 
const handleSubmit = async () => { 
// 手动触发表单校验
const valid = await formRef.value.validate() 
if (!valid) return 
// 校验不通过,终止提交 
// 校验通过,再执行提交逻辑 
console.log('表单校验通过,提交数据:', formData) 
} 
</script>
相关推荐
IT_陈寒19 小时前
Redis那个过期删除策略,差点让我线上崩了
前端·人工智能·后端
jianqiang.xue19 小时前
Espressif-IDE进入维护模式:乐鑫把ESP32开发的宝押给VS Code
前端·css·ide
特创数字科技19 小时前
纯本地离线运行的文档脱敏工具(技术分享)
前端·驱动开发·python
心之语歌20 小时前
uni-app uts原生插件开发:uts 与 Kotlin 交互踩坑实录(附解决方案)
前端·后端
再吃一根胡萝卜20 小时前
DSH 插件数据链路:Host 管数据,Client 只管画
前端
feixing_fx20 小时前
CSS 变量(Custom Properties):构建可扩展的主题切换系统
前端·css·前端框架·html·css3
十有八七21 小时前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下21 小时前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
跳跳的小星星1 天前
自研组件】Vue2 + ElementUI 通用列表页封装 wkjp-list-page,一套配置搞定搜索、动态表格、分页、增删改
前端
tryCbest1 天前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js