Skip to content

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,以下列出常用默认值与扩展属性:

属性类型默认值说明
closeOnClickModalbooleantrue点击弹窗外部遮罩关闭,仍经过 beforeClose 拦截
draggablebooleanfalse是否允许从标题栏拖动
resizableboolean | DialogResizeOptionsfalse是否允许从边缘调整尺寸
constrainToViewportbooleantrue尺寸允许时将弹窗限制在视口内
resetOnClosebooleantrue关闭时是否恢复初始尺寸和位置

DialogResizeOptions:

属性类型说明
minWidthnumber最小宽度,默认不低于初始宽度的 30% 和 200
minHeightnumber最小高度,默认不低于初始高度的 30% 和 120
maxWidthnumber最大宽度,默认视口宽度
maxHeightnumber最大高度,默认视口高度
handlesDialogResizeHandle[]t/b/l/r/tl/tr/bl/br,默认全部方向
edgeSizenumber边缘命中宽度;桌面默认 10,触控默认 16

Events ​

除 Element Plus 原有事件外,组件还会发送:

事件参数说明
dragStartDialogInteractionState开始拖动
dragEndDialogInteractionState拖动结束
resizeStartDialogInteractionState开始调整尺寸
resizeEndDialogInteractionState尺寸调整结束

实例方法 ​

  • reset():恢复初始尺寸和位置;
  • resetPosition():只恢复位置。

键盘操作 ​

标题栏获得焦点后:

  • Alt + 方向键:移动弹窗;
  • Alt + Shift + 方向键:调整宽度或高度;
  • Alt + Home:恢复初始尺寸和位置。

全屏模式下拖动和缩放会自动停用。弹窗正文在高度不足时独立滚动,标题和底部操作区保持可见。