Skip to content
On this page

TForm 表单组件


基础用法

继承 Element-plus 组件的事件使用

el-input 去除前后空格(type=password 除外)

对齐方式

每行展示多少项

表单校验规则

自定义 label jsx 渲染

输入框插槽使用

文本展示

结合自己封装组件使用

赋值回显数据

密码在新增显示,编辑不显示

TForm 参数配置


1. 简介:基于 Element-plus Form 表单组件的二次封装,着重于数据层面,HTML 一行代码

TForm 表单组件 代码示例:

html
<t-form
  v-model="formOpts.ref"
  :formOpts="formOpts"
  :widthSize="2"
  @handleEvent="handleEvent"
/>
//注意formOpts.ref(t-form组件实例相当于vue2 ref)需要要v-model接收
<t-form
  v-model="formOpts.ref"
  :formOpts="formOpts"
  :widthSize="2"
  @handleEvent="handleEvent"
/>
//注意formOpts.ref(t-form组件实例相当于vue2 ref)需要要v-model接收

2. 配置参数

参数说明类型是否必须
className自定义类名String-
labelPosition改变表单项 label 与输入框的布局方式(默认:right) /topStringright
widthSize每行显示几个输入项(默认两项) 最大值 6Number2
isTrim全局是否开启清除前后空格(comp 为 el-input 且 type 不等于'password')Booleantrue
formOpts表单配置项Object-
---listTypeInfo下拉选择数据源(type:'select'有效)Object-
---fieldListform 表单每项 listArray是-
------isHideItem某一项不显示Booleanfalse
------slotName自定义表单某一项输入框slot-
------childSlotName自定义表单某一下拉选择项子组件插槽(el-option)slot-
------compform 表单每一项组件是输入框还是下拉选择等(可使用第三方 UI 如 el-select/el-input 也可以使用自定义组件)String-
------bind表单每一项属性(继承第三方 UI 的 Attributes,如 el-input 中的 clearable 清空功能)默认清空及下拉过滤Object/funnction-
------isSelfCom是否使用自己封装的组件(即不需要嵌套el-option等)Booleanfalse
------isTrim是否不清除前后空格(comp 为 el-input 且 type 不等于'password')Booleanfalse
------typeform 表单每一项类型String-
------widthSizeform 表单某一项所占比例(如果占一整行则设置 1)Number-
------widthform 表单某一项所占实际宽度String-
------arrLabeltype=select-arr 时,每个下拉显示的中文Stringlabel
------arrKeytype=select-arr 时,每个下拉显示的中文传后台的数字Stringkey
------labelform 表单每一项 titleString-
------labelRender自定义某一项 titlefunction-
------valueform 表单每一项传给后台的参数String-
------rules每一项输入框的表单校验规则Object/Array-
------list下拉选择数据源(仅仅对 type:'select'有效)String-
------event表单每一项事件标志(即是:handleEvent 事件第一个参数值)String-
------eventHandle继承 comp 组件的事件Object-
---formData表单提交数据(对应 fieldList 每一项的 value 值)Object-
---labelWidthlabel 宽度String120px
---rules规则(可依据 elementUI el-form 配置————对应 formData 的值)Object/Array-
---operatorList操作按钮 listArray-
-------bind继承el-button所有Attributes(默认值{ type:'primary',size:'small',})Object-
-------fun事件名function-

3. events

事件名说明返回值
handleEvent单个查询条件触发事件fieldList 中 type/查询条件输入的值/fieldList 中 event 值

4. Methods 继承 element-plus 的 methods

事件名说明返回值
selfValidate自定义校验valid:Boolean;formData:object
selfResetFields自定义重置方法(主要清空使用TSelectTable组件)-

5. 关于 element-plus el-form/el-form-item 提供的一些方法/属性可直接使用,无需其他配置