VUE3-Elementplus-form表单-笔记

1. 结构相关

el-row表示一行，一行分成24份

el-col表示列

(1) :span="12" 代表在一行中，占12份 (50%)

(2) :span="6" 表示在一行中，占6份 (25%)

(3) :offset="3" 代表在一行中，左侧margin份数

el-form 整个表单组件

el-form-item 表单的一行（一个表单域）

el-input 表单元素（输入框）

2. 校验相关

(1) el-form => :model="ruleForm" 绑定的整个form的数据对象 { xxx, xxx, xxx }

(2) el-form => :rules="rules" 绑定的整个rules规则对象 { xxx, xxx, xxx }

(3) 表单元素 => v-model="ruleForm.xxx" 给表单元素，绑定form的子属性

(4) el-form-item => prop配置生效的是哪个校验规则 (和rules中的字段要对应)

/ 整个表单的校验规则

// 1. 非空校验 required: true message消息提示， trigger触发校验的时机 blur change

// 2. 长度校验 min:xx, max: xx

// 3. 正则校验 pattern: 正则规则 \S 非空字符

// 4. 自定义校验 => 自己写逻辑校验 (校验函数)

// validator: (rule, value, callback)

// (1) rule 当前校验规则相关的信息

// (2) value 所校验的表单元素目前的表单值

// (3) callback 无论成功还是失败，都需要 callback 回调

// - callback() 校验成功

// - callback(new Error(错误信息)) 校验失败

相应代码：

vue3中，以按需引入了elementplus和icons


<script setup>
import { User, Lock } from '@element-plus/icons-vue'
import {ref} from 'vue'

const isRegister = ref(false)
//用于提交整个form表单数据
const formModel=ref({
  username:'',
  password:'',
  repassword:''
})
//用于校验表单数据
const rules={
  username: [
    { required: true, message: '请输入用户名', trigger: 'blur' },
    { min: 5, max: 10, message: '用户名必须是5-10位的字符', trigger: 'blur' }
  ],
  password: [
    { required: true, message: '请输入密码', trigger: 'blur' },
    { pattern: /^\S{6,15}$/, message: '密码必须是6-15位', trigger: 'blur' }
  ],
  //自定义校验
  repassword:[
  { required: true, message: '请输入密码', trigger: 'blur' },
  { pattern: /^\S{6,15}$/, message: '密码必须是6-15位', trigger: 'blur' },
  {
    validate:(rule,value,callback)=>{
    if(value!==formModel.value.password){
      callback(new Error('两次输入的密码不一致'))
    }else{
      callback()//不成功也要callback 
    }
  }
  }
  ]
}
</script>                                           
<template>
  <!-- el-row表示一行，一行表示24分 -->
   <!-- ：span表示一行中占几份 ：offset在一行中左侧margin份数 -->
  <el-row class="login-page">
    <el-col :span="12" class="bg"></el-col>
    <el-col :span="6" :offset="3" class="form">
      <!-- 注册相关表单 -->
      <el-form
      :model="formModel"
      :rules="rules"
        ref="form"
        size="large"
        autocomplete="off"
        v-if="isRegister"
      >
        <el-form-item>
          <h1>注册</h1>
        </el-form-item>
        <el-form-item prop="username">
          <el-input
          v-model="formModel.username"
            :prefix-icon="User"
            placeholder="请输入用户名"
          ></el-input>
        </el-form-item>
        <el-form-item prop="password">
          <el-input
          v-model="formModel.password"
            :prefix-icon="Lock"
            type="password"
            placeholder="请输入密码"
          ></el-input>
        </el-form-item>
        <el-form-item prop="repassword">
          <el-input
          v-model="formModel.repassword"
            :prefix-icon="Lock"
            type="password"
            placeholder="请输入再次密码"
          ></el-input>
        </el-form-item>
        <el-form-item>
          <el-button
            class="button"
            type="primary"
            auto-insert-space
          >
            注册
          </el-button>
        </el-form-item>
        <el-form-item class="flex">
          <el-link type="info" :underline="false" @click="isRegister = false">
            ← 返回
          </el-link>
        </el-form-item>
      </el-form>

      <!-- 登录相关表单 -->
      <el-form
      :model="formModel"
      :rules="rules"
        size="large"
        autocomplete="off"
        v-else
      >
        <el-form-item>
          <h1>登录</h1>
        </el-form-item>
        <el-form-item prop="username">
          <el-input
          v-model="formModel.username"
            :prefix-icon="User"
            placeholder="请输入用户名"
          ></el-input>
        </el-form-item>
        <el-form-item prop="password">
          <el-input
          v-model="formModel.password"
            :prefix-icon="Lock"
            type="password"
            placeholder="请输入密码"
          ></el-input>
        </el-form-item>
        <el-form-item class="flex">
          <div class="flex">
            <el-checkbox>记住我</el-checkbox>
            <el-link type="primary" :underline="false">忘记密码？</el-link>
          </div>
        </el-form-item>
        <el-form-item>
          <el-button
            class="button"
            type="primary"
            auto-insert-space
          >
            登录
          </el-button>
        </el-form-item>
        <el-form-item class="flex">
          <el-link type="info" :underline="false" @click="isRegister = true">
            注册 →
          </el-link>
        </el-form-item>
      </el-form>
    </el-col>
  </el-row>
</template>


<style lang="scss" scoped>
.login-page {
  height: 100vh;
  background-color: #fff;
  .bg {
    background: url('../../assets/logo2.png') no-repeat 60% center / 240px auto,
      url('../../assets/login_bg.jpg') no-repeat center / cover;
    border-radius: 0 20px 20px 0;
  }
  .form {
    display: flex;
    flex-direction: column;
    justify-content: center;
    user-select: none;
    .title {
      margin: 0 auto;
    }
    .button {
      width: 100%;
    }
    .flex {
      width: 100%;
      display: flex;
      justify-content: space-between;
    }
  }
}
</style>

代码中理解点：

实例代码：

const rules = {
  username: [
    { required: true, message: '请输入用户名', trigger: 'blur' }, // 必填项，触发条件为失焦
    { min: 5, max: 10, message: '用户名必须是5-10位的字符', trigger: 'blur' } // 字符长度限制，触发条件为失焦
  ],
  password: [
    { required: true, message: '请输入密码', trigger: 'blur' }, // 必填项，触发条件为失焦
    { pattern: /^\S{6,15}$/, message: '密码必须是6-15位', trigger: 'blur' }, // 正则表达式，非空白字符，长度6-15，触发条件为失焦
    { validator: validatePassword, trigger: 'blur' } // 自定义校验函数，触发条件为失焦
  ],
  email: [
    { required: true, message: '请输入邮箱地址', trigger: 'blur' }, // 必填项，触发条件为失焦
    { type: 'email', message: '请输入正确的邮箱地址', trigger: 'blur' } // 类型为邮箱，触发条件为失焦
  ],
  age: [
    { type: 'number', min: 18, max: 60, message: '年龄必须在18到60岁之间', trigger: 'blur' } // 类型为数字，数值范围18-60，触发条件为失焦
  ],
  website: [
    { type: 'url', message: '请输入正确的网址', trigger: 'blur' } // 类型为网址，触发条件为失焦
  ],
  agree: [
    { type: 'boolean', required: true, message: '请同意协议', trigger: 'change' } // 类型为布尔值，必填项，触发条件为改变
  ],
  colors: [
    { type: 'array', required: true, message: '请选择至少一个颜色', trigger: 'change' } // 类型为数组，必填项，触发条件为改变
  ],
  birthdate: [
    { type: 'date', required: true, message: '请选择生日', trigger: 'change' } // 类型为日期，必填项，触发条件为改变
  ],
  phone: [
    { pattern: /^1[34578]\d{9}$/, message: '请输入正确的手机号码', trigger: 'blur' } // 正则表达式，校验手机号码，触发条件为失焦
  ],
  hexColor: [
    { type: 'hex', message: '请输入正确的16进制颜色值', trigger: 'blur' } // 类型为16进制颜色值，触发条件为失焦
  ],
  custom: [
    { validator: customValidator, trigger: 'change' } // 自定义校验函数，触发条件为改变
  ]
};

// 自定义校验函数
const validatePassword = (rule, value, callback) => {
  if (value.length < 8) {
    callback(new Error('密码至少8位'));
  } else {
    callback();
  }
};

const customValidator = (rule, value, callback) => {
  if (value !== 'customValue') {
    callback(new Error('自定义校验不通过'));
  } else {
    callback();
  }
};

解释

required: 必填项。
javascript
复制代码

{ required: true, message: '请输入用户名', trigger: 'blur' }
min 和 max: 限制长度或数值范围。
javascript
复制代码

{ min: 5, max: 10, message: '用户名必须是5-10位的字符', trigger: 'blur' }
pattern: 正则表达式校验。
javascript
复制代码

{ pattern: /^\S{6,15}$/, message: '密码必须是6-15位', trigger: 'blur' }
type: 校验字段的类型。
javascript
复制代码

{ type: 'email', message: '请输入正确的邮箱地址', trigger: 'blur' }
其他类型包括：string, number, boolean, method, regexp, integer, float, array, object, enum, date, url, hex。
validator: 自定义校验函数。
javascript
复制代码

{ validator: validatePassword, trigger: 'blur' }
len: 校验长度（适用于字符串和数组）。
javascript
复制代码

{ len: 6, message: '长度必须为6位', trigger: 'blur' }
enum: 枚举类型校验。
javascript
复制代码

{ type: 'enum', enum: ['option1', 'option2'], message: '请选择一个有效的选项', trigger: 'change' }
whitespace: 校验字段是否包含空白字符。
javascript
复制代码

{ whitespace: true, message: '该字段不能包含空格', trigger: 'blur' }
trigger: 定义校验规则触发的条件。
javascript
复制代码

trigger: 'blur' // 或 'change'
transform: 在校验前对字段的值进行转换。
javascript
复制代码

{ type: 'number', transform(value) { return Number(value); }, message: '请输入有效的数字', trigger: 'blur' }