一、需求场景以及注意事项
需求场景
1.用户输入数值,点击按钮弹出对话框的同时,按照用户输入的数值进行表单的渲染。
2.点击按钮之后,渲染效果如下:
注意事项
首先声明我这里使用的是ant-design,现在只要在网上一搜都是vue+element的动态生成以及数据绑定,所以就打算出一篇文章记录一下。
下面先说与UI框架无关的注意事项,无论使用的是Element还是ant都要关注的点,在文末会说有关于ant生成表单的校验规则。
以下几点是重点内容,建议细品。
- 1.在初始情况下,每一个表单项(比如说每一个input)的绑定数据都为空,也就是在data中无定义,但是整个表单的数据绑定为空数组。这个空数组就相当于表单项数据绑定的载体。
- 2.在渲染表单,也就是渲染DOM元素之前,必须填充这个空数组,使数组中的值与表单项需要绑定的值一一对应。除此之外,只要是在动态生成的内容中中,需要绑定的数据,都需要在渲染之前动态生成完毕。
- 3.在渲染表单之前,必须使用v-if判断数组是否为空,为空则不渲染。
- 4.此处v-if不得使用v-show代替,因为v-show代表的是页面元素存在,处于隐藏状态。但是我们需要绑定的数据还没生成好,最终会报一堆undefined。而v-if的本质是操作DOM,控制其是否渲染,而v-show是操作样式,控制其显示隐藏。
二、代码结构
template中
此处会体现注意点三和四
1.我这里使用的Number函数是ant提供的,作用就是将用户输入的数值由字符串转换成Number类型,注意转换成Number类型是必须进行的,如果是字符串,遍历出来的也只是字符串中的具体字符。
转换成Number之后效果也就类似于:
for(let i = 0; i < arr.length; i++)
<!-- 监测构建信息对话框 --> <a-modal :title="monitorTitle" :visible="monitorModalVisible" @ok="monitorModalOk" @cancel="monitorModalCancel" okText="确定" cancelText="取消" :width=850> <!-- 当控制展开折叠的数组有值时再渲染:注意点三/四 --> <div v-if="monitorExpand.length > 0"> <!-- 通过数值一循环生成监测区 --> <div v-for="(item1,index1) in Number(addForm.add_monitor_number)" :key="index1"> <!-- 监测区标题与展开折叠文字 --> <div class="monitor"> <span class="monitor_title">监测区-{{item1}}</span> <!-- 控制监测区折叠与展开的文字与图标 --> <div> <span v-show="monitorExpand[index1].expanded" @click="monitorFormExpand(index1)" style="color:#4257B9;cursor: pointer;"> <a-icon type="up"/> <span>折叠</span> </span> <span v-show="!monitorExpand[index1].expanded" @click="monitorFormExpand(index1)" style="color:#4257B9;cursor: pointer;"> <a-icon type="down"/> <span>展开</span> </span> </div> </div> <!-- 监测区表单,需要展开折叠的效果,所以需要变量来控制 --> <div class="monitor_form" v-show="monitorExpand[index1].expanded"> <a-form-model ref="monitorFormRef" :model="monitorForm" :label-col="{span:6}" :wrapper-col="{ span: 17 }"> <a-row> <a-col :span="12"> <a-form-model-item label="名称:" :rules="{ required: true, message: '名称不能为空', trigger: 'blur'}" :prop="'monitor_area.'+index1+'.monitor_name'"> <a-input v-model="monitorForm.monitor_area[index1].monitor_name" placeholder="请输入监测构建信息" :disabled="modalDisabled"/> </a-form-model-item> </a-col> <a-col :span="12"> <a-form-model-item label="位置:" :rules="{ required: true, message: '位置不能为空', trigger: 'blur'}" :prop="'monitor_area.'+index1+'.monitor_position'"> <a-input v-model="monitorForm.monitor_area[index1].monitor_position" placeholder="请输入监测构建信息" :disabled="modalDisabled"/> </a-form-model-item> </a-col> </a-row> <a-form-model-item label="监测点数值:" :label-col="{span:3}" :wrapper-col="{ span:21 }"> <!-- 通过数值二循环生成监测点数 --> <a-col :span="4" v-for="(item2,index2) in Number(addForm.add_point_number)" :key="index2"> <a-form-model-item :style="{ marginRight:'5px'}" :rules="{ required: true, message: '数值不能为空', trigger: 'blur'}" :prop="'monitor_area.'+index1+'.points.'+index2"> <a-input v-model="monitorForm.monitor_area[index1].points[index2]" :placeholder="index2+1" :disabled="modalDisabled"/> </a-form-model-item> </a-col> </a-form-model-item> </a-form-model> </div> </div> </div> </a-modal>
data中
此处会体现注意点一
methods中的按钮事件,也就是触发渲染之前的事件
1.事件绑定
2.事件处理函数
此处体现注意点三:页面DOM元素渲染之前必须生成该DOM元素需要绑定的相关数据。
此处的折叠展开也是相关数据,也需要渲染之前生成好。
此处我的绑定数据是通过按钮生成的,大家也可以根据自己的实际需求,以其他事件为介质。
// 按钮点击事件 inputPointMessage(){ // 在添加时,只有输入了测区数量以及监测点数,才能进行构建信息的填写 if(this.addTitle=='添加'){ if(this.addForm.add_monitor_number == ''){ return this.$message.warning('请先输入测区数量') } if(this.addForm.add_point_number == '') return this.$message.warning('请先输入监测点数') } // 生成控制折叠展开的数组和表单绑定对象,使用let声明,避免出现意外的全局变量 for(let i = 0; i < this.addForm.add_monitor_number ;i++){ // 生成控制折叠展开的数组 this.monitorExpand.push({expanded:true}); // 生成表单绑定对象 this.monitorForm.monitor_area.push({ // 名称 monitor_name :'', // 位置 monitor_position :'', // 保存监测点数的数组 points :[] }) } // 打开对话框 this.monitorModalVisible = true },
3.控制展开与折叠的事件处理函数
// 信息表单的展开折叠 monitorFormExpand(index){ this.monitorExpand[index].expanded = !this.monitorExpand[index].expanded },
三、ant-design中的校验规则
a-form-model
1.在此标签上不进行rules属性的绑定,但是需要绑定model属性 。
a-form-model-item
1.在此标签上必须绑定prop属性,外带一张ant官网截图说明。由于我们需要使用校验规则,所以该属性的绑定是必须的。
2.在此标签上必须绑定rules属性,用于定义校验规则。
3.如果还看不懂可看官网有关于FormModel组件的最后一个演示示例。我就是根据这个将需求写出来的。
四、在点击对话框确定按钮时获取该表单对象,并得出打印结果
五、遇到的问题及优化
数据提交前校验
通过我之前的方式生成的表单是多个,那么vue实例中,一个monitorFormRef就对应了多个,如下:
那么这个数组的每一项都会有一个validate方法,只能循环调用validate方法了:
// 监测构建信息对话框确定按钮 monitorModalOk(){ // 在点击对话框确定的时候,对表单进行校验 console.log(this.$refs.monitorFormRef) // 创建空数组,保存多个校验结果 let valids = [] this.$refs.monitorFormRef.forEach((item)=>{ item.validate(valid => { // 将校验结果保存到数组中,当前item对应表单的校验全部通过为true,否则为false valids.push(valid) }); }); console.log(valids,'valids') // 遍历校验结果数组,只要一个为false,则返回false,否则返回true let finalValid = valids.every((item)=>{ return item == true }); console.log(finalValid,'finalValid') // 当全部表单的表单项没有全部通过,直接返回 if(!finalValid) return // 执行拿到数据之后的业务代码,业务代码不进行演示 // 关闭当前对话框 this.monitorModalVisible = false },
优化一:element-ui同样适用
只有用户输入了前面提到的数值一和数值二(只能是正整数,不包含零),再继续向下进行,以及表单的渲染,之前是只拿了字符串非空进行校验,之前的代码已经注释掉,目前修改如下:
数值一和数值二的校验规则一样,只体现其一:
// 测区数量 add_monitor_number: [{required: true, message: '测区数量不能为空', trigger: 'blur' }, {type:'number',message:'仅支持输入正整数(不包含0)', trigger: 'blur',transform(value){ if(value){ // 将输入的值转为数字 var val = Number(value) if(/^[+]{0,1}(\d+)$/.test(val) && val != 0) return val // 返回false即为校验失败 return false } }} ],
// 按钮点击事件 // 按钮点击事件 inputPointMessage(){ // 定义变量判断用户输入了相应的值才可以进行表单的渲染,都通过校验时为true,否则为false let tempValid = true; // 对数值一和数值二两个值的正确性进行校验(只能是正整数,不包含零),只有两个值的校验通过了才可以继续对表单进行渲染 this.$refs.addFormRef.validateField(['add_monitor_number','add_point_number'],(error)=>{ // 当error存在即校验未全部通过, if (error) tempValid = false; }) console.log(tempValid) // 校验不通过直接返回 if(!tempValid) return; // if(this.addTitle=='添加'){ // if(this.addForm.add_monitor_number == ''){ // return this.$message.warning('请先输入测区数量') // } // if(this.addForm.add_point_number == ''){ // return this.$message.warning('请先输入监测点数') // } // } // 生成控制折叠展开的数组和表单绑定对象,使用let声明,避免出现意外的全局变量 for(let i = 0; i < this.addForm.add_monitor_number ;i++){ // 生成控制折叠展开的数组 this.monitorExpand.push({expanded:true}); // 生成表单绑定对象 this.monitorForm.monitor_area.push({ // 名称 monitor_name :'', // 位置 monitor_position :'', // 保存监测点数的数组 points :[] }) } // 打开对话框 this.monitorModalVisible = true },
循环生成表单数据重复,在点击时生成,多次点击就会多次生成,在生成前添加判断即可
当前表单绑定的数据有值时,不再生成表单绑定数据。
// 当前表单没有绑定数据时,生成表单对象 if(this.monitorForm.monitor_area.length == 0){ // 生成控制折叠展开的数组和表单绑定对象,使用let声明,避免出现意外的全局变量 for(let i = 0; i < this.addForm.add_monitor_number ;i++){ // 生成控制折叠展开的数组 this.monitorExpand.push({expanded:true}); // 生成表单绑定对象 this.monitorForm.monitor_area.push({ // 名称 actual_measure_region_name :'', // 位置 actual_measure_region_position :'', // 保存监测点数的数组 actual_measure_region_value :[] }) } }
以上为个人经验,希望能给大家一个参考,也希望大家多多支持阿兔在线工具。