Skip to content

DrawerForm 表单

DrawerForm 组件是 ElDrawerPlusForm 组件的组合,是在 PlusForm 组件上自定义 footer 的基础上构建而来,除下文提到 PlusDrawerForm 特有的属性和方法外,同时支持 PlusForm 组件的所有自定义函数和插槽。

注意

表单v-model绑定的值尽量使用 ref 定义绑定的值,以避免 reactive 带来的响应式丢失问题。 参考 reactive 的局限性

基础用法

自定义表单项

支持 PlusForm 自定义表单项 自定义表单项 的三种(renderField/slot/jsx)方式。

自定义表单 label

支持 PlusForm 自定义表单 label 自定义表单项 的三种(renderLabel/slot/jsx)`方式。

DrawerForm API

DrawerForm Attributes

名称说明类型默认值是否必须
model-value / v-model表单绑定 (尽量使用 ref 定义绑定的值,以避免 reactive 带来的响应式丢失问题)objectFieldValues
visible / v-model:visible抽屉显示booleanfalse
closeOnClickModalElDrawercloseOnClickModalbooleanfalse
closeOnPressEscapeElDrawercloseOnPressEscapebooleanfalse
titletitlestring抽屉表单
sizeDrawer 窗体的大小, 当使用 number 类型时, 以像素为单位, 当使用 string 类型时, 请传入 'x%', 否则便会以 number 类型解释string/number540px
hasFooter是否需要底部按钮booleantrue
cancelText取消按钮文本string取消
confirmText确认按钮文本string确认
confirmLoading确认按钮 loadingbooleanfalse
formPlusForm 的 propsobjectPlusFormProps{hasFooter:false}
drawer deprecated v0.1.6ElDrawer 的 propsobjectElDrawerProps{closeOnClickModal:false,closeOnPressEscape:false, title:"抽屉表单"}
hasErrorTipv0.0.10是否需要校验 message 提示booleantrue
... v0.1.6............

...表示同时支持所有ElDrawer Attributes

DrawerForm Events

名称说明类型
submit deprecated v0.0.10点击确定按钮校验通过触发的事件,已废弃,请使用confirm代替function
confirmv0.0.10点击确定按钮校验通过触发的事件function
cancel点击取消按钮触发的事件function
change表单变化触发的事件function
submitErrorv0.0.10点击提交按钮校验不通过触发的事件function

DrawerForm Slots

插槽名说明作用域插槽参数
drawer-headerElDrawer 的 header slot
drawer-footerElDrawer 的 footer slot
form-footerPlusForm 的 footer slot{handleReset,handleSubmit}
tooltip-iconv0.0.3PlusForm 的 tooltip icon
form-group-headerPlusForm 的 group-header slot{title,columns,icon}
plus-field-*PlusForm 的自定义表单项,组件会自动根据配置项的 prop 生成对应的插槽{prop,label,fieldProps,valueType,column}
plus-label-*PlusForm 的自定义表单项 label,组件会自动根据配置项的 prop 生成对应的插槽{prop,label,fieldProps,valueType,column}
plus-extra-*PlusForm的自定义渲染 el-form-item 下一行额外的内容,组件会自动根据配置项的 prop 生成对应的插槽{column}

Exposes

名称说明类型
formInstanceel-form 实例object
drawerInstanceel-drawer 实例object