一、封装介绍
封装前景:表单内容多、表单类型重复且校验项较多
下面就参考element
的例子写个实例
element地址:https://element.eleme.cn/2.15/#/zh-CN/component/form
实现效果如下:
今天给大家写三种表单+校验实现方式
- 普通表单实现、正常定义
rules
并支持json多
层级 - 循环表单实现、正常定义
rules
并支持json
多层级 - 循环表单实现、封装
rules
并支持json
多层级
二、实现方式
1、普通表单实现、正常定义rules并支持json多层级
如果表单简单 且 没有 重复表单类型推荐使用
下面写一个普通表单实现、正常定义rules
并支持json
多层级的例子 ,不做多解释,直接看代码 代码如下:
主要语法如下:
<!-- HTML -->
<el-form :model="ruleForm" :rules="rules" ref="ruleForm">
<el-form-item label="label1" prop="prop1" >
<el-input v-model="ruleForm.prop1" ></el-input>
</el-form-item>
<!-- 多层级json数据 -->
<el-form-item label="label2" prop="infos.prop2" >
<el-input v-model="ruleForm.infos.prop2" ></el-input>
</el-form-item>
</el-form>
/**
* js
*/
data() {
return {
ruleForm: {
prop1: '',
// 多层级json数据
infos:{
prop2: '',
}
},
rules: {
prop1: [
{ required: true, message: '请输入内容', trigger: 'blur' },
],
"infos.prop2": [
{ required: true, message: '内容', trigger: 'change' }
],
}
};
},
普通表单实现、正常定义
rules
并支持json
多层级实例:
<template>
<div>
<el-form :model="ruleForm" :rules="rules" ref="ruleForm" label-width="100px" class="demo-ruleForm"
>
<el-form-item label="活动名称" prop="name" >
<el-input v-model="ruleForm.name" placeholder="请输入活动名称"></el-input>
</el-form-item>
<el-form-item label="活动区域" prop="region">
<el-select v-model="ruleForm.region" placeholder="请选择活动区域">
<el-option label="区域一" value="shanghai"></el-option>
<el-option label="区域二" value="beijing"></el-option>
</el-select>
</el-form-item>
<!-- 多层级json数据 -->
<el-form-item label="特殊资源" prop="testInfos.resource">
<el-radio-group v-model="ruleForm.testInfos.resource">
<el-radio label="线上品牌商赞助"></el-radio>
<el-radio label="线下场地免费"></el-radio>
</el-radio-group>
</el-form-item>
<!-- 多层级json数据 -->
<el-form-item label="活动形式" prop="testInfos.desc">
<el-input type="textarea" v-model="ruleForm.testInfos.desc" placeholder="请填写活动形式"></el-input>
</el-form-item>
<el-form-item>
<el-button type="primary" @click="submitForm('ruleForm')">立即创建</el-button>
<el-button @click="resetForm('ruleForm')">重置</el-button>
</el-form-item>
</el-form>
</div>
</template>
<script>
export default {
data() {
return {
ruleForm: {
name: '',
region: '',
// 多层级json数据
testInfos:{
resource: '',
desc: '',
}
},
rules: {
name: [
{ required: true, message: '请输入活动名称', trigger: 'blur' }
],
region: [
{ required: true, message: '请选择活动区域', trigger: 'change' }
],
"testInfos.resource": [
{ required: true, message: '请选择活动资源', trigger: 'change' }
],
"testInfos.desc": [
{ required: true, message: '请填写活动形式', trigger: 'blur' }
]
}
};
},
created(){
},
methods: {
submitForm(formName) {
this.$refs[formName].validate((valid) => {
if (valid) {
alert('submit!');
} else {
console.log('error submit!!');
return false;
}
});
},
resetForm(formName) {
this.$refs[formName].resetFields();
}
}
}
</script>
<style scoped>
.demo-ruleForm{
width: 50%;
}
</style>
2、循环表单实现、正常定义rules并支持json多层级
如果 表单简单 且 有 重复表单类型推荐使用
下面写一个循环表单实现、正常定义rules
并支持json
多层级的例子 ,不做多解释,直接看实例代码
代码如下:
<template>
<div>
<!-- :rules="rules" -->
<el-form :model="ruleForm" ref="ruleForm" label-width="100px" class="demo-ruleForm">
<div v-for="item in formList" :key="item?.propChildren ? item.propChildren : item.prop " >
<el-form-item :label="item.label" :prop="item.props" :rules="item.require ? item.rules : []">
<el-input v-model="ruleForm[item.prop]" :placeholder="item.message" v-if="item.type==='input'"></el-input>
<el-select v-model="ruleForm[item.prop]" :placeholder="item.message" v-if="item.type==='select'">
<!-- 这里就不做数据处理了,就写死两条数据 -->
<el-option label="区域一" value="shanghai"></el-option>
<el-option label="区域二" value="beijing"></el-option>
</el-select>
<!-- 多层级json数据 -->
<el-radio-group v-model="ruleForm[item.prop][item.propChildren]" v-if="item.type==='radio'">
<!-- 这里就不做数据处理了,就写死两条数据 -->
<el-radio label="线上品牌商赞助"></el-radio>
<el-radio label="线下场地免费"></el-radio>
</el-radio-group>
<!-- 多层级json数据 -->
<el-input type="textarea"
v-model="ruleForm[item.prop][item.propChildren]"
:placeholder="item.message"
v-if="item.type==='textarea'"></el-input>
</el-form-item>
</div>
<el-form-item>
<el-button type="primary" @click="submitForm('ruleForm')">立即创建</el-button>
<el-button @click="resetForm('ruleForm')">重置</el-button>
</el-form-item>
</el-form>
</div>
</template>
<script>
/**
* js
*/
export default {
data() {
return {
formList:[{
label: '活动名称',
props: 'name',
type: 'input',
require: true,
message: '请输入活动名称',
},{
label: '活动区域',
props: 'region',
type: 'select',
require: true,
message: '请选择活动区域',
},{
label: '特殊资源',
props: 'testInfos.resource',
prop:'testInfos',
propChildren: 'resource',
type: 'radio',
require: true,
message: '请选择活动资源',
},{
label: '活动形式',
props: 'testInfos.desc',
prop:'testInfos',
propChildren: 'desc',
type: 'textarea',
require: true,
message: '请填写活动形式',
}],
ruleForm: {
name: '',
region: '',
// 多层级json数据
testInfos:{
resource: '',
desc: '',
}
},
};
},
created(){
this.addRules()
},
methods: {
// 封装rules
addRules(){
let ruleObj = {}
this.formList.forEach(item => {
const rule = {
required: item.require,
message: item.message,
trigger: ['input', 'textarea'].includes(item.type) ? ['blur'] : ['change', 'blur']
}
ruleObj = rule
item.rules = [ruleObj]
})
console.log("this.formList==",this.formList)
},
submitForm(formName) {
this.$refs[formName].validate((valid) => {
if (valid) {
alert('submit!');
} else {
console.log('error submit!!');
return false;
}
});
},
resetForm(formName) {
this.$refs[formName].resetFields();
}
}
}
</script>
<style scoped>
.demo-ruleForm{
width: 50%;
}
</style>
3、循环表单实现、封装rules并支持json多层级
如果 表单复杂 且 有 重复表单类型推荐使用
下面写一个循环表单实现、正常定义rules
并支持json
多层级的例子 ,不做多解释,直接看实例代码
代码如下:
<template>
<div>
<!-- :rules="rules" -->
<el-form :model="ruleForm" ref="ruleForm" label-width="100px" class="demo-ruleForm">
<div v-for="item in formList" :key="item?.propChildren ? item.propChildren : item.prop " >
<el-form-item :label="item.label" :prop="item.props" :rules="item.require ? item.rules : []">
<el-input v-model="ruleForm[item.prop]" :placeholder="item.message" v-if="item.type==='input'"></el-input>
<el-select v-model="ruleForm[item.prop]" :placeholder="item.message" v-if="item.type==='select'">
<!-- 这里就不做数据处理了,就写死两条数据 -->
<el-option label="区域一" value="shanghai"></el-option>
<el-option label="区域二" value="beijing"></el-option>
</el-select>
<!-- 多层级json数据 -->
<el-radio-group v-model="ruleForm[item.prop][item.propChildren]" v-if="item.type==='radio'">
<!-- 这里就不做数据处理了,就写死两条数据 -->
<el-radio label="线上品牌商赞助"></el-radio>
<el-radio label="线下场地免费"></el-radio>
</el-radio-group>
<!-- 多层级json数据 -->
<el-input type="textarea"
v-model="ruleForm[item.prop][item.propChildren]"
:placeholder="item.message"
v-if="item.type==='textarea'"></el-input>
</el-form-item>
</div>
<el-form-item>
<el-button type="primary" @click="submitForm('ruleForm')">立即创建</el-button>
<el-button @click="resetForm('ruleForm')">重置</el-button>
</el-form-item>
</el-form>
</div>
</template>
<script>
/**
* js
*/
export default {
data() {
return {
formList:[{
label: '活动名称',
props: 'name',
type: 'input',
require: true,
message: '请输入活动名称',
},{
label: '活动区域',
props: 'region',
type: 'select',
require: true,
message: '请选择活动区域',
},{
label: '特殊资源',
props: 'testInfos.resource',
prop:'testInfos',
propChildren: 'resource',
type: 'radio',
require: true,
message: '请选择活动资源',
},{
label: '活动形式',
props: 'testInfos.desc',
prop:'testInfos',
propChildren: 'desc',
type: 'textarea',
require: true,
message: '请填写活动形式',
}],
ruleForm: {
name: '',
region: '',
// 多层级json数据
testInfos:{
resource: '',
desc: '',
}
},
};
},
created(){
this.addRules()
},
methods: {
addRules(){
let ruleObj = {}
this.formList.forEach(item => {
const rule = {
required: item.require,
message: item.message,
trigger: ['input', 'textarea'].includes(item.type) ? ['blur'] : ['change', 'blur']
}
ruleObj = rule
item.rules = [ruleObj]
})
console.log("this.formList==",this.formList)
},
submitForm(formName) {
this.$refs[formName].validate((valid) => {
if (valid) {
alert('submit!');
} else {
console.log('error submit!!');
return false;
}
});
},
resetForm(formName) {
this.$refs[formName].resetFields();
}
}
}
</script>
<style scoped>
.demo-ruleForm{
width: 50%;
}
</style>
三、注意事项
for
循环实现表单的json
多层级的v-model
写法为v-model="ruleForm[item.prop][item.propChildren]"
- 封装
rules
时rules
写在<el-form-item :rules="item.rules"></el-form-item >
标签上,非封装的情况下写在<el-form :rules="rules"></el-form>
标签上
四、总结
以上只是写了一个简单的实列,很多情况都没有处理、比如自定义校验规则、重复使用表单类型等;而且例子上的select
、radio
的数据都是写死的,大家可以处理一下,其实可以把表单封装成一个组件的形式,方便项目中使用,然后处理使用表单时遇到的各种情况!
有什么不足的希望大家多多提出!