Vue项目的表单校验实战指南
作者:巴啦啦不亮w
一、表单检验
1.作用:前端校验可以省去一些错误的请求提交,为后端节省接口压力
2.流程:
表单数据 =》 前端校验(过滤错误请求) =》 后端查询是否匹配
3.工具:ElementPlus表单组件。https://element-plus.org/zh-CN/component/form.html
- el-form(绑定表单和规则对象)
- el-form-item(绑定使用的规则字段)
- el-input(双向绑定表单数据)
当功能很复杂的时候,通过多个组件各自负责某个小功能,再组合成一个大功能
二、步骤
- 按照接口字段准备表单对象并绑定
- 按照产品要求准备规则对象并绑定
- 指定表单域的校验字段名
- 把表单对象进行双向绑定
用户名:不能为空,字段名为account
密码:不能为空且为6-14个字符,字段名为password
同意协议:勾选,字段名为agree
三、前期准备
在src文件夹下的views文件夹下创建一个Login文件夹,然后创建一个Index.vue文件,写入以下代码:
<script setup> import { RouterLink } from 'vue-router'; import { ref } from 'vue'; </script> <template> <div> <header class="login-header"> <div class="container m-top-20"> <h1 class="logo"> <RouterLink to="/">小兔鲜</RouterLink> </h1> <RouterLink class="entry" to="/"> 进入网站首页 <i class="iconfont icon-angle-right"></i> <i class="iconfont icon-angle-right"></i> </RouterLink> </div> </header> <section class="login-section"> <div class="wrapper"> <nav> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >账户登录</a> </nav> <div class="account-box"> <div class="form"> <el-form label-position="right" label-width="60px" status-icon> <el-form-item label="账户"> <el-input/> </el-form-item> <el-form-item label="密码"> <el-input/> </el-form-item> <el-form-item label-width="22px"> <el-checkbox size="large"> 我已同意隐私条款和服务条款 </el-checkbox> </el-form-item> <el-button size="large" class="subBtn">点击登录</el-button> </el-form> </div> </div> </div> </section> <footer class="login-footer"> <div class="container"> <p> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >关于我们</a> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >帮助中心</a> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >售后服务</a> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >配送与验收</a> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >商务合作</a> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >搜索推荐</a> <a href="javascript:;" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >友情链接</a> </p> <p>CopyRight © 小兔鲜儿</p> </div> </footer> </div> </template> <style scoped lang='scss'> .login-header { background: #fff; border-bottom: 1px solid #e4e4e4; .container { display: flex; align-items: flex-end; justify-content: space-between; } .logo { width: 200px; a { display: block; height: 132px; width: 100%; text-indent: -9999px; background: url("@/assets/images/logo.png") no-repeat center 18px / contain; } } .sub { flex: 1; font-size: 24px; font-weight: normal; margin-bottom: 38px; margin-left: 20px; color: #666; } .entry { width: 120px; margin-bottom: 38px; font-size: 16px; i { font-size: 14px; color: $xtxColor; letter-spacing: -5px; } } } .login-section { background: url('@/assets/images/login-bg.png') no-repeat center / cover; height: 488px; position: relative; .wrapper { width: 380px; background: #fff; position: absolute; left: 50%; top: 54px; transform: translate3d(100px, 0, 0); box-shadow: 0 0 10px rgba(0, 0, 0, 0.15); nav { font-size: 14px; height: 55px; margin-bottom: 20px; border-bottom: 1px solid #f5f5f5; display: flex; padding: 0 40px; text-align: right; align-items: center; a { flex: 1; line-height: 1; display: inline-block; font-size: 18px; position: relative; text-align: center; } } } } .login-footer { padding: 30px 0 50px; background: #fff; p { text-align: center; color: #999; padding-top: 20px; a { line-height: 1; padding: 0 10px; color: #999; display: inline-block; ~a { border-left: 1px solid #ccc; } } } } .account-box { .toggle { padding: 15px 40px; text-align: right; a { color: $xtxColor; i { font-size: 14px; } } } .form { padding: 0 20px 20px 20px; &-item { margin-bottom: 28px; .input { position: relative; height: 36px; >i { width: 34px; height: 34px; background: #cfcdcd; color: #fff; position: absolute; left: 1px; top: 1px; text-align: center; line-height: 34px; font-size: 18px; } input { padding-left: 44px; border: 1px solid #cfcdcd; height: 36px; line-height: 36px; width: 100%; &.error { border-color: $priceColor; } &.active, &:focus { border-color: $xtxColor; } } .code { position: absolute; right: 1px; top: 1px; text-align: center; line-height: 34px; font-size: 14px; background: #f5f5f5; color: #666; width: 90px; height: 34px; cursor: pointer; } } >.error { position: absolute; font-size: 12px; line-height: 28px; color: $priceColor; i { font-size: 14px; margin-right: 2px; } } } .agree { a { color: #069; } } .btn { display: block; width: 100%; height: 40px; color: #fff; text-align: center; line-height: 40px; background: $xtxColor; &.disabled { background: #cfcdcd; } } } .action { padding: 20px 40px; display: flex; justify-content: space-between; align-items: center; .url { a { color: #999; margin-left: 10px; } } } } .subBtn { background: $xtxColor; width: 100%; color: #fff; } </style>
效果图:
四、实战
(1)账号和密码的表单验证
1.按照接口字段准备表单对象并绑定
(1)先准备好表单对象
// 1.准备表单对象 const form =ref({ account: '', password: '' })
(2)接着做一个绑定,对el-form组件进行一个绑定 :model
<el-form :model="form" label-position="right" label-width="60px" status-icon>
2.按照产品要求准备规则对象并绑定
(1)先准备规则对象
// 2.准备规则对象 const rules = { account : [ {required:true , message:'用户名不能为空!' , trigger :'blur'} ], password : [ {required: true , message:'密码不能为空!' , trigger :'blur'}, {min :6 ,max : 14 , message:'密码长度是6-14位!' , trigger :'blur'}, ] }
- required: true表示用户名(密码)是必须的,不能为空。
- message: 是在验证失败时显示的错误消息。
- trigger: 'blur'表示当用户离开输入框(失去焦点)时触发验证。
- min:最小长度
- max:最大长度
(2)对el-form进行规则对象绑定
<el-form :model="form" :rules="rules" label-position="right" label-width="60px" status-icon>
3.指定表单域的校验字段名
给el-form-item添加校验字段名prop=" "
<el-form-item prop="account" label="账户"> <el-input/> </el-form-item> <el-form-item prop="password" label="密码"> <el-input/> </el-form-item>
4.把表单对象进行双向绑定
对el-input进行双向绑定v-model
<el-input v-model="form.account"/>
<el-input v-model="form.password"/>
5.验证看效果
我们可以发现,我们之前设置的验证规则都生效的,账号密码都不能为空,它们前面都带有星号
(2)同意协议的表单验证
使用自定义校验规则,举个栗子
其中三个参数分别代表:
- rule:验证的规则。
- value:当前输入的数据。
- callback:一个回调函数,用于在验证完成后执行。如果验证通过,通常会调用
callback()
;如果验证失败,可能会调用callback(new Error('错误信息'))。
同意协议的校验逻辑:如果勾选了,通过校验,反之。
同样是我们的四个步骤走:
- 按照接口字段准备表单对象并绑定
// 1.准备表单对象 const form =ref({ account: '', password: '', agree: true })
因为在上面我们已经对表单对象进行绑定了,这里就不需要了
<el-form :model="form" :rules="rules" label-position="right" label-width="60px" status-icon>
按照产品要求准备规则对象并绑定
// 2.准备规则对象 const rules = { account : [ {required:true , message:'用户名不能为空!' , trigger :'blur'} ], password : [ {required: true , message:'密码不能为空!' , trigger :'blur'}, {min :6 ,max : 14 , message:'密码长度是6-14位!' , trigger :'blur'}, ], agree : [ { validator:(rule,value,callback) => { console.log(value); // 勾选就通过,不勾选就不通过 if(value){ callback() }else{ callback(new Error('请勾选协议!')) } } } ] }
指定表单域的校验字段名
<el-form-item prop="agree" label-width="22px">
把表单对象进行双向绑定
<el-checkbox v-model="form.agree" size="large">
看效果:
(3)整个表单内容验证
问题:每个表单域都有自己的检验触发事件,如果用户一上来就点击登录怎么办?
解决:在点击登录时需要对所有需要检验的表单进行统一检验。
步骤:
获取表单实例(先获取一个form实例,然后对其绑定)
// 3.获取form实例做同意校验 const formRef = ref(null)
<el-form ref="formRef" :model="form" :rules="rules" label-position="right" label-width="60px" status-icon>
调用实例方法(先给登录按钮绑定一个doLogin方法,然后再去定义这个方法)
总结
到此这篇关于Vue项目表单校验的文章就介绍到这了,更多相关Vue项目表单校验内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!