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-inputv-model="formModel.username":prefix-icon="User"placeholder="请输入用户名"></el-input></el-form-item><el-form-item prop="password"><el-inputv-model="formModel.password":prefix-icon="Lock"type="password"placeholder="请输入密码"></el-input></el-form-item><el-form-item prop="repassword"><el-inputv-model="formModel.repassword":prefix-icon="Lock"type="password"placeholder="请输入再次密码"></el-input></el-form-item><el-form-item><el-buttonclass="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-inputv-model="formModel.username":prefix-icon="User"placeholder="请输入用户名"></el-input></el-form-item><el-form-item prop="password"><el-inputv-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-buttonclass="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' }