Skip to content

Dialog 对话框

基础用法

可以使用open方法来打开对话框

对话框宽度

可以在打开的时候使用width定义对话框宽度

对话框高度

可以在打开的时候使用height定义对话框高度;可以使用固定高度或者百分比高度,使用百分比高度时,推荐将dialogalign-center设置为true,百分比高度基于window.innerHeight来计算;高度包括 header和footer的高度

手动处理确定事件

通过confrim函数来手动处理确定事件,如果不传confrim,则点击确定按钮后默认关闭

手动处理取消事件

通过cancel函数来手动处理取消事件,如果不传cancel,则点击取消按钮后默认关闭

按钮文字

通过confirmBtnTextcancelBtnText来控制确定和取消按钮的文字

确定按钮的loading

通过confrim函数中的loadingstopLoading参数来控制确定按钮的加载状态

插槽

通过插槽自定义 header 和 footer

Dialog Attributes

名称说明类型默认值
dialogProps透传给 ElDialog 的原生 props(会与全局 setDialogConfigdialogProps 合并)Partial<DialogProps>{}
getAsyncDataWhenEveryOpen配合弹窗内 ElhForm 使用时,是否每次 open 都调用 form.getAsyncData()booleantrue

Dialog Expose

ElhDialog 通过 defineExpose 暴露 DialogInstance

名称说明类型
open打开弹窗,可传本次打开参数<T = any>(dialogOpenOptions?: DialogOpenOptions<T>) => void
inject内部注入对象(主要用于表单实例注入)DialogInject

DialogOpenOptions

名称说明类型默认值
title弹窗标题string''
top弹窗顶部偏移(ElDialogtopstring沿用 ElDialog 默认
width弹窗宽度string | number'50%'
height内容区高度(支持固定值或百分比;最终会扣除 header/footer 与 padding)string'auto'
confirmBtnText确认按钮文本string'确定'
cancelBtnText取消按钮文本string'取消'
validateForm存在注入表单时,点击确认是否先校验表单booleantrue
setFormData打开后设置表单数据,可返回对象/Promise,并可通过回调拿到 form 实例做额外处理((callback: (func: (form: FormInstance) => void) => void) => V) | nullnull
confirm点击确认回调(param: DialogConfirmParam<T>) => void-
cancel点击取消或关闭回调(param: DialogCloseParam) => void-

DialogConfirmParam

名称说明类型
close关闭弹窗() => void
data表单数据(有表单时为表单数据;无表单时为 nullT
loading开启确认按钮 loading() => void
stopLoading关闭确认按钮 loading() => void

DialogCloseParam

名称说明类型
close关闭弹窗() => void

DialogInject

名称说明类型
form注入的表单实例(弹窗中包含 ElhForm 时可用)FormInstance

MIT Licensed.