首页 文章 精选 留言 我的

精选列表

搜索[云 API],共10000篇文章
优秀的个人博客,低调大师

前端配置化表单组件设计方法 | 京东云技术团队

一、背景 前端开发中涉及表单的页面非常多,看似功能简单,开发快速,实则占去了很大一部分时间。当某个表单包含元素过多时还会导致html代码过多,vue文件过大。从而不容易查找、修改和维护。为了提高开发效率及降低维护成本,下面介绍表单配置化组件的封装原理与封装方法。 二、技术方案 如上图所示,封装表单配置化组件的关键点有三个一是如何解决表单元素排布的行列问题,二是表单数据的绑定问题,三是表单元素的参数配置校验等问题。下面分别介绍这三个问题的解决方法。 •配置化表单组件的入参及说明 参数 说明 类型 可选值 默认值 labelWidth 表单元素label所占宽度 String —— 150px columnList 表单元素所组成的配置,是一个数组 Array —— [] formData 表单元素值的集合 Object —— {} columnSpan 表单排布分栏 Number —— 24 size 表单元素尺寸 String medium / small / mini medium •计算配置化表单的行数,本表单通过基础的24分栏计算表单最终的行数和列数,通过下面方法最终得到一个关于行列的二维数组 newColumnList() { const newColumnList= [] const row = Math.floor(24 / this.columnSpan) let newColumnItem = [] for(let i=0; i< this.columnList.length; i++) { newColumnItem.push(this.columnList[i]) if(newColumnItem.length === row || i === this.columnList.length-1) { newColumnList.push(newColumnItem) newColumnItem = [] } } return newColumnList } •通过上面得到的二维数组进行循环渲染,首先循环渲染行,其次循环渲染列。本方案采用element中的表单,当然也可以用其他组件库或者原生表单进行渲染,其原理通用。最终将会根据参数column.type决定加载哪一个具体的表单元素。 <el-form ref="form" :model="formData" :label-width="labelWidth" :size="size"> <el-row :gutter="20" v-for="(element,index) in newColumnList" :key="index+'formRow'"> <template v-for="(item, index) in element" > <column :key="index + 'formView'" :columnSpan="columnSpan" :column="item" :formData="formData" /> </template> </el-row> </el-form> •column组件最终根据type加载具体的表单元素。下面展示column组件的入参及其说明,通过component加载不同的表单元素 参数 说明 类型 可选值 默认值 column 表单元素的具体配置 Object —— {} formData 表单元素值的集合 Object —— {} columnSpan 表单排布分栏 Number —— 24 <el-col :span="columnSpan"> <component :is="column.type + 'View'" :column="column" :formData="formData" v-model="formData[column.name]" :columnSpan="columnSpan"/> </el-col> •这里主要以select表单元素为例进行说明,表单元素的双向绑定、校验以及值更新等问题 参数 说明 类型 可选值 默认值 column 表单元素的具体配置 Object —— {} value 表单元素值 Number/String/Array —— —— •column参数 参数 说明 类型 可选值 默认值 placeholder 空值说明 String —— —— required 是否必填 Boolean —— —— rules 校验规则 Array —— —— title 表单元素label String —— —— name 表单元素值名称 String —— —— multiple 是否多选 Boolean —— —— filterable 是否过滤 Boolean —— —— disabled 是否禁用 Boolean —— —— dictionary 下拉选项枚举 Array —— —— changeFunction 值改变时的回调函数 Function —— —— <el-form-item :label="column.title + ':'" :prop="column.name" :rules="rules"> <el-select v-model="val" clearable :multiple="column.multiple" :filterable="column.filterable" :placeholder="'请选择' + column.title" :disabled="column.disabled" style="width: 100%" @change="onChange" @clear="onClear"> <el-option v-for="item in column.dictionary" :key="item.code" :label="item.name" :value="item.code"> </el-option> </el-select> </el-form-item> rules: [ { required: this.column.required, message: this.column.placeholder placeholder ? this.column.placeholder : `请输入${this.column.title}`, trigger: 'change' }, ...this.column.rules ] onChange(){ this.$emit('input',this.val) if(this.column && this.column.changeFunction){ this.column.changeFunction(this.val) } }, onClear(){ this.onChange() } 三、项目实践 •配置化表单为bs-form,在页面中引入bs-form表单组件 <bs-form ref="formDemo" :columnList="columnList" :formData="formData" :columnSpan="columnSpan" labelWidth="120px"> </bs-form> <el-row style="text-align: center;"> <el-button type="primary" @click="onSave">保存</el-button> <el-button @click="onCancel">取消</el-button> </el-row> •formData参数 formData: { name: '', yearIncome: '', // 业务类型 goodsCategoryId: '', // 托寄物品类id projectManagerErp: '', // 项目经理erp projectName: '', // 项目名称 projectStage: '', // 项目阶段编码 projectStandardName: '', // 标准名称 projectYear: 2023, // 年份 startRegionId: '', // 始发区域id startBattleId: '', // 始发战区id address: [], // 省市 category: null, //图文类型 range: [] //发布范围 } •分栏参数 columnSpan: 6 •表单配置参数 columnList(){ const self = this return [ { type: 'text', name: 'name', title: '项目名称', required: true, maxlength: 20, showwordlimit: true, placeholder: '请输入' }, { name: 'category', type: 'radio', dictionary: [ { code: 1, name: '类型一' }, { code: 2, name: '类型二' } ], title: '图文类型', required: true }, { name: 'range', type: 'checkbox', title: '发布范围', dictionary: [ { code: 1, name: '范围一' }, { code: 2, name: '范围二' } ], required: true }, { type: 'text', // 字段类型文本框 name: 'yearIncome', //与后台对接字段 title: '年均收入', // 前端展示字段 required: true, // 必填项设置 maxlength: 50, // 字符串长度限制 showwordlimit: true, // 是否显示字符串长度 placeholder: '请输入', // 占位文本提示 rules: [ { pattern: /(^[1-9]([0-9]+)?(.[0-9]{1,2})?$)|(^(0){1}$)|(^[0-9].[0-9]([0-9])?$)/, message: '请输入数字最多两位小数' } ], }, { type: 'select', name: 'goodsCategoryId', title: '托寄物品类', required: true, filterable: true, placeholder: '请选择', dictionary: [{ name: '苹果', code: '1' },{ name: '手机', code: '2' },{ name: '测试', code: '3' },{ name: '樱桃', code: '7' },{ name: '荸荠', code: '9' }] }, { type: 'select', name: 'startRegionId', title: '区域', required: true, placeholder: '请选择', dictionary: [{ name: '销售-华北区域', code: '1' },{ name: '销售-华东区域', code: '2' },{ name: '销售-华南区域', code: '3' },{ name: '销售-西南区域', code: '4' },{ name: '销售-华中区域', code: '5' },{ name: '销售-东北区域', code: '6' }], // 点击下来触发切换联动的事件,为一个函数 changeFunction: function (val) { } }, { type: 'select', name: 'startBattleId', title: '战区', required: true, placeholder: '请选择', dictionary: this.battleByRegionList }, { type: 'select', name: 'projectStage', title: '项目阶段', required: true, placeholder: '请选择', dictionary: [{ name: '项目发起阶段', code: '10' },{ name: '项目调研阶段', code: '20' },{ name: '可行性分析阶段', code: '30' },{ name: '立项阶段', code: '40' }] }, { type: 'text', name: 'projectStandardName', title: '标准名称', required: true, placeholder: '请输入', append: '.com', // 文本框后置内容 }, { type: 'text', name: 'projectManagerErp', title: '项目经理', required: true, placeholder: '请输入' },{ type: 'cascader', // 字段类型下拉框 name: 'address', //与后台对接字段 title: '省市区', // 前端展示字段 required: true, // 必填项设置 placeholder:'请选择', // 占位文本提示 dictionary: [{ value: 'shanxi', label: '陕西省', children: [{ value: 'xian', label: '西安市', children: [{ value: 'yanta', label: '雁塔区' }, { value: 'beilin', label: '碑林区' }, { value: 'xincheng', label: '新城区' }, { value: 'weiyang', label: '未央区' }] }] }], // 点击下来触发切换联动的事件,为一个函数 changeFunction: function(){} },{ type: 'static', name: 'projectYear', title: '年份' } ] } •表单保存 // 保存 async onSave() { const valid = await this.$refs.formDemo.onValidate() if(valid) { this.$message.success('校验通过') }else { this.$message.error('校验失败') } } 四、成果展示 作者:京东物流 田雷雷

资源下载

更多资源
优质分享App

优质分享App

近一个月的开发和优化,本站点的第一个app全新上线。该app采用极致压缩,本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

腾讯云软件源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题,腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构,目前腾讯云软件源站支持公网访问和内网访问。

Sublime Text

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能,例如代码缩略图,Python的插件,代码段等。还可自定义键绑定,菜单和工具栏。Sublime Text 的主要功能包括:拼写检查,书签,完整的 Python API , Goto 功能,即时项目切换,多选择,多窗口等等。Sublime Text 是一个跨平台的编辑器,同时支持Windows、Linux、Mac OS X等操作系统。

用户登录
用户注册
修改密码
忘记密码