正文

elementui表单验证技巧：轻松应对提交环节，告别错误信息烦恼

/0 浏览量
0402

在开发过程中，表单验证是一个必不可少的环节。Element UI作为Vue.js的UI库，提供了强大的表单验证功能，可以帮助开发者轻松实现各种复杂的验证需求。本文将为你介绍一些Element UI表单验证的技巧，让你在提交环节告别错误信息烦恼。

1. 简单的表单验证

首先，我们需要创建一个简单的表单，并添加一些验证规则。

<template>
  <el-form :model="form" :rules="rules" ref="form" label-width="100px">
    <el-form-item label="用户名" prop="username">
      <el-input v-model="form.username"></el-input>
    </el-form-item>
    <el-form-item label="密码" prop="password">
      <el-input type="password" v-model="form.password"></el-input>
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="submitForm('form')">提交</el-button>
    </el-form-item>
  </el-form>
</template>

<script>
export default {
  data() {
    return {
      form: {
        username: '',
        password: ''
      },
      rules: {
        username: [
          { required: true, message: '请输入用户名', trigger: 'blur' },
          { min: 3, max: 15, message: '用户名长度在 3 到 15 个字符', trigger: 'blur' }
        ],
        password: [
          { required: true, message: '请输入密码', trigger: 'blur' },
          { min: 6, max: 15, message: '密码长度在 6 到 15 个字符', trigger: 'blur' }
        ]
      }
    };
  },
  methods: {
    submitForm(formName) {
      this.$refs[formName].validate((valid) => {
        if (valid) {
          alert('提交成功!');
        } else {
          alert('请检查输入!');
          return false;
        }
      });
    }
  }
};
</script>

2. 自定义验证规则

Element UI允许我们自定义验证规则，以适应更复杂的验证需求。

<template>
  <el-form :model="form" :rules="rules" ref="form" label-width="100px">
    <el-form-item label="邮箱" prop="email">
      <el-input v-model="form.email"></el-input>
    </el-form-item>
    <el-form-item label="手机号" prop="phone">
      <el-input v-model="form.phone"></el-input>
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="submitForm('form')">提交</el-button>
    </el-form-item>
  </el-form>
</template>

<script>
export default {
  data() {
    return {
      form: {
        email: '',
        phone: ''
      },
      rules: {
        email: [
          { required: true, message: '请输入邮箱地址', trigger: 'blur' },
          { type: 'email', message: '请输入正确的邮箱地址', trigger: ['blur', 'change'] }
        ],
        phone: [
          { required: true, message: '请输入手机号', trigger: 'blur' },
          { pattern: /^1[3-9]\d{9}$/, message: '请输入正确的手机号', trigger: ['blur', 'change'] }
        ]
      }
    };
  },
  methods: {
    submitForm(formName) {
      this.$refs[formName].validate((valid) => {
        if (valid) {
          alert('提交成功!');
        } else {
          alert('请检查输入!');
          return false;
        }
      });
    }
  }
};
</script>

3. 使用表单验证钩子

Element UI提供了表单验证钩子，可以让我们在表单验证的过程中执行一些自定义逻辑。

<template>
  <el-form :model="form" :rules="rules" ref="form" label-width="100px">
    <el-form-item label="姓名" prop="name">
      <el-input v-model="form.name"></el-input>
    </el-form-item>
    <el-form-item label="年龄" prop="age">
      <el-input v-model.number="form.age"></el-input>
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="submitForm('form')">提交</el-button>
    </el-form-item>
  </el-form>
</template>

<script>
export default {
  data() {
    return {
      form: {
        name: '',
        age: ''
      },
      rules: {
        name: [
          { required: true, message: '请输入姓名', trigger: 'blur' }
        ],
        age: [
          { required: true, message: '请输入年龄', trigger: 'blur' },
          { type: 'number', message: '年龄必须为数字值' },
          { min: 18, max: 65, message: '年龄必须在18到65岁之间' }
        ]
      }
    };
  },
  methods: {
    submitForm(formName) {
      this.$refs[formName].validate((valid) => {
        if (valid) {
          alert('提交成功!');
        } else {
          alert('请检查输入!');
          return false;
        }
      });
    }
  }
};
</script>

4. 使用异步验证

在实际情况中，我们可能需要使用异步验证来验证某些信息。Element UI允许我们自定义验证方法，并返回一个Promise对象。

<template>
  <el-form :model="form" :rules="rules" ref="form" label-width="100px">
    <el-form-item label="邮箱" prop="email">
      <el-input v-model="form.email"></el-input>
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="submitForm('form')">提交</el-button>
    </el-form-item>
  </el-form>
</template>

<script>
export default {
  data() {
    return {
      form: {
        email: ''
      },
      rules: {
        email: [
          { required: true, message: '请输入邮箱地址', trigger: 'blur' },
          { validator: this.checkEmail, trigger: ['blur', 'change'] }
        ]
      }
    };
  },
  methods: {
    checkEmail(rule, value, callback) {
      if (!value) {
        return callback(new Error('请输入邮箱地址'));
      }
      const emailRegex = /^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/;
      if (!emailRegex.test(value)) {
        return callback(new Error('请输入正确的邮箱地址'));
      }
      callback();
    },
    submitForm(formName) {
      this.$refs[formName].validate((valid) => {
        if (valid) {
          alert('提交成功!');
        } else {
          alert('请检查输入!');
          return false;
        }
      });
    }
  }
};
</script>

总结

Element UI的表单验证功能非常强大，可以帮助开发者轻松应对各种复杂的验证需求。通过以上几个技巧，相信你已经掌握了Element UI表单验证的核心。在今后的开发过程中，灵活运用这些技巧，让你在表单验证环节游刃有余。

-- 展开阅读全文 --