Vue项目的表单校验实战指南

更新时间：2024年10月21日 10:21:33 作者：巴啦啦不亮w

这篇文章主要介绍了Vue项目表单校验的相关资料,前端表单校验能减少无效请求,保护后端接口,使用ElementPlus表单组件进行校验,需要准备表单对象、规则对象并进行双向绑定,用户名、密码以及协议勾选等字段都需符合特定规则,需要的朋友可以参考下

一、表单检验

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 &copy; 小兔鲜儿</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项目表单校验内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

vue中使用echarts以及简单关系图的点击事件方式
这篇文章主要介绍了vue中使用echarts以及简单关系图的点击事件方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-06-06
Vue 实现点击空白处隐藏某节点的三种方式(指令、普通、遮罩）
最近小编接到这样的需求：弹出框（或Popover）在 show 后，点击空白处可以将其 hide。针对这个需求，小编整理了三种实现方式，如果大家对vue 点击空白隐藏节点问题感兴趣的朋友跟随小编一起看看吧
2019-10-10
vuex提交state&&实时监听state数据的改变方法
今天小编就为大家分享一篇vuex提交state&&实时监听state数据的改变方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-09-09
vue 使用 vue-pdf 实现pdf在线预览的示例代码
这篇文章主要介绍了vue 使用 vue-pdf 实现pdf在线预览的示例代码，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-04-04
vue3中组件事件和defineEmits示例代码
这篇文章主要给大家介绍了关于vue3中组件事件和defineEmits的相关资料,组件事件是Vue组件之间进行通信的一种方式,文中通过代码示例介绍的非常详细,需要的朋友可以参考下
2023-10-10
vue在外部方法给下拉框赋值后不显示label的解决
这篇文章主要介绍了vue在外部方法给下拉框赋值后不显示label的解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-10-10
基于Vue3+TypeScript实现图片预览组件
在现代的 Web 应用中,图片预览是一个常见的需求,本文将介绍如何使用 Vue3 和 TypeScript 开发一个图片预览组件,支持展示单张或多张图片,并提供了丰富的配置选项,需要的朋友可以参考下
2024-04-04
如何使用vue3+uni-app封装音乐播放插件
UniApp是一个基于Vue.js开发的跨平台应用开发框架,它可以使用一套代码同时构建iOS、Android和Web应用,这篇文章主要给大家介绍了关于如何使用vue3+uni-app封装音乐播放插件的相关资料,需要的朋友可以参考下
2023-11-11
Vue使用vue-draggable 插件在不同列表之间拖拽功能
这篇文章主要介绍了使用vue-draggable 插件在不同列表之间拖拽,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-03-03
vue时间转换的几种方式
这篇文章主要介绍了vue时间转换的几种方式,需要的朋友可以参考下
2022-05-05