外观
KvDialog
基于 Element Plus ElDialog 的可拖动、可调整尺寸弹窗。拖动和缩放使用同一套位移状态,不会互相覆盖 transform。
实时预览
可拖动、可调整尺寸弹窗
点击按钮打开弹窗,然后尝试拖动标题栏或调整边缘尺寸。
业务新增表单和新增/编辑共用表单默认使用 KvFormDrawer。本组件保留用于明确需要居中、拖动或缩放的场景。
默认点击弹窗外部的遮罩空白可关闭,与关闭按钮一样经过 beforeClose 拦截。需要禁用遮罩关闭时,设置 :close-on-click-modal="false"。
示例代码
vue
<script setup lang="ts">
import { ref } from 'vue'
import { KvDialog } from '@kevairy/components'
const visible = ref(false)
</script>
<template>
<el-button @click="visible = true">打开弹窗</el-button>
<KvDialog
v-model="visible"
title="编辑配置"
width="720px"
draggable
:resizable="{ minWidth: 400, minHeight: 240 }"
>
弹窗内容
<template #footer>
<el-button @click="visible = false">关闭</el-button>
</template>
</KvDialog>
</template>Props
组件支持 Element Plus ElDialog 的全部 props,以下列出常用默认值与扩展属性:
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
closeOnClickModal | boolean | true | 点击弹窗外部遮罩关闭,仍经过 beforeClose 拦截 |
draggable | boolean | false | 是否允许从标题栏拖动 |
resizable | boolean | DialogResizeOptions | false | 是否允许从边缘调整尺寸 |
constrainToViewport | boolean | true | 尺寸允许时将弹窗限制在视口内 |
resetOnClose | boolean | true | 关闭时是否恢复初始尺寸和位置 |
DialogResizeOptions:
| 属性 | 类型 | 说明 |
|---|---|---|
minWidth | number | 最小宽度,默认不低于初始宽度的 30% 和 200 |
minHeight | number | 最小高度,默认不低于初始高度的 30% 和 120 |
maxWidth | number | 最大宽度,默认视口宽度 |
maxHeight | number | 最大高度,默认视口高度 |
handles | DialogResizeHandle[] | t/b/l/r/tl/tr/bl/br,默认全部方向 |
edgeSize | number | 边缘命中宽度;桌面默认 10,触控默认 16 |
Events
除 Element Plus 原有事件外,组件还会发送:
| 事件 | 参数 | 说明 |
|---|---|---|
dragStart | DialogInteractionState | 开始拖动 |
dragEnd | DialogInteractionState | 拖动结束 |
resizeStart | DialogInteractionState | 开始调整尺寸 |
resizeEnd | DialogInteractionState | 尺寸调整结束 |
实例方法
reset():恢复初始尺寸和位置;resetPosition():只恢复位置。
键盘操作
标题栏获得焦点后:
Alt + 方向键:移动弹窗;Alt + Shift + 方向键:调整宽度或高度;Alt + Home:恢复初始尺寸和位置。
全屏模式下拖动和缩放会自动停用。弹窗正文在高度不足时独立滚动,标题和底部操作区保持可见。