element表单校验新玩法:一键定位未通过字段位置

本文详细介绍如何在Element UI表单中实现校验不通过时,自动定位到错误字段,提升用户体验。通过添加事件处理和ref属性,确保快速反馈和高效率填写。

前言

在网页表单的开发中,表单校验是一个非常重要的环节。如果表单校验未通过时,能够直接定位到未通过字段位置,将极大地提升用户体验。不仅能够让用户快速找到错误的地方进行修改,也能够减少用户在整个表单页面的浏览时间,提高用户的工作效率。那么,如何实现这一功能呢?本文将为大家详细介绍 element 表单校验未通过定位到未通过字段位置的实现方法,让你的网页表单变得更加智能、易用。


优化前:

在这里插入图片描述


优化后:

在这里插入图片描述


实现思路:

  1. 首先我们需要给提交事件添加一个参数 object
  2. 当校验不通过时收集所有未通过字段项提示信息,将其通过 push 方法添加到定义好的数组中(str);
  3. 通过 this.$refs[Object.keys(object)[0]] 获取到首个字段校验不通过的提示信息;
  4. 利用 Object.prototype.toString.call() 方法判断 this.$refs[Object.keys(object)[0]] 的类型是否为对象的字符串形式;
  5. 最后通过 scrollIntoView 方法滚动到首个不通过校验字段项。

代码实现起来也非常简单,如下:

methods: {
  // 事件方法
  submitForm(formName) {
    this.$refs[formName].validate((valid, object) => {
      if (valid) {
        //校验通过执行逻辑
      } else {
        let str = [];
        for (let key in object) {
          object[key].map((item) => {
            str.push(item.message);
          });
          let dom = this.$refs[Object.keys(object)[0]];
          if (Object.prototype.toString.call(dom) !== "[object Object]") {
            dom = dom[0];
            break;//结束语句并跳出语句,进行下个语句执行
          }
          // 定位代码
          dom.$el.scrollIntoView({
            block: "center",
            behavior: "smooth",
          });
        }
        // 页面提示未通过校验字段项,并以逗号分隔
        this.$message.error(str.join(","));
      }
    });
  },
},

注意: 必填字段项的 el-form-item 需要添加 ref ,作用主要是用来定位(ref 的值建议与 prop 同名)。

在这里插入图片描述

在使用 Element Plus 进行表单校验时,如果希望在校验失败后自动定位到第一个错误字段位置,可以通过结合 `Form` 组件的 `validate` 方法和 DOM 操作实现。Element Plus 的 `el-form` 提供了对表单校验的支持,并通过 `ref` 可以调用相关方法获取错误信息。 以下是一个完整的实现方案: ### 自动滚动到第一个错误字段 可以通过调用 `el-form` 的 `validate` 方法触发表单校验,并利用其返回的 Promise 来判断是否通过校验。在校验失败的情况下,可以访问 `model` 中的错误字段,并通过 `scrollIntoView` 方法将页面滚动至第一个错误字段位置。 ```vue <template> <el-form ref="form" :model="formData" :rules="rules" label-width="120px"> <el-form-item label="用户名" prop="username"> <el-input v-model="formData.username" /> </el-form-item> <el-form-item label="邮箱" prop="email"> <el-input v-model="formData.email" /> </el-form-item> <el-form-item> <el-button @click="submitForm">提交</el-button> </el-form-item> </el-form> </template> <script setup> import { ref } from 'vue'; const form = ref(); const formData = ref({ username: '', email: '' }); const rules = { username: [ { required: true, message: '请输入用户名', trigger: 'blur' } ], email: [ { required: true, message: '请输入邮箱地址', trigger: 'blur' }, { type: 'email', message: '请输入正确的邮箱格式', trigger: ['blur', 'change'] } ] }; const submitForm = () => { form.value.validate((valid) => { if (valid) { alert('提交成功'); } else { // 获取表单错误字段 const errorFields = document.querySelectorAll('.el-form-item__content .el-input.is-error'); if (errorFields.length > 0) { errorFields[0].scrollIntoView({ behavior: 'smooth', block: 'center' }); } return false; } }); }; </script> ``` ### 实现说明 - **`form.value.validate()`**:触发表单校验,返回一个布尔值表示是否通过校验。 - **DOM 查询 `.is-error` 类**:Element Plus 在校验失败的字段上会添加 `is-error` 类,通过查询该类可以获取所有校验失败的输入框。 - **`scrollIntoView()`**:用于平滑滚动到第一个错误字段位置,提升用户体验[^1]。 ### 注意事项 - 如果表单结构较为复杂(如嵌套、分步表单等),可能需要根据实际 DOM 结构调整选择器。 - 对于动态生成的表单项,确保 DOM 已经渲染完成后再执行滚动操作。
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

水星记_

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值