如果使用Vue3.0实现一个 Modal,你会怎么进行设计?
参考答案
设计要点
Modal 的核心不是「画一个框」,而是分层、可复用、可控:布局层(遮罩 + 容器)、状态层(open/close、loading)、交互层(关闭方式)、能力层(无障碍、动画、嵌套、层级)。
1. 组件契约
<!-- Modal.vue -->
<script setup>
const props = defineProps({
modelValue: Boolean, // v-model 控制显隐
title: String,
width: { type: [String, Number], default: 520 },
closable: { type: Boolean, default: true }, // 右上角 ×
maskClosable: { type: Boolean, default: true }, // 点遮罩关闭
escClosable: { type: Boolean, default: true },
destroyOnClose: Boolean, // 关闭后销毁内容
appendToBody: { type: Boolean, default: true },
})
const emit = defineEmits(['update:modelValue', 'ok', 'cancel', 'open', 'close', 'after-close'])
const visible = defineModel() // 或 computed get/set 包 props.modelValue
</script>
2. 结构
<Teleport to="body"> ← 避免被父级 overflow/z-index 裁剪
<Transition name="fade"> ← 遮罩动画
<div class="mask" @click.self="onMaskClick">
<Transition name="zoom">
<div class="modal" role="dialog" aria-modal="true" :aria-label="title">
<header>{{ title }}<button v-if="closable" @click="close">×</button></header>
<slot /> ← 内容
<footer><slot name="footer"> ← 默认按钮区
<button @click="onCancel">取消</button>
<button @click="onOk">确定</button>
</slot></footer>
</div>
</Transition>
</div>
</Transition>
</Teleport>
3. 关键实现细节
- 显隐与动画:用
ref控制visible,Transition做进出场;关闭时先播动画再emit('update:modelValue', false)(或destroyOnClose时等after-leave再销毁内容)。 - 层级管理:多个 Modal 叠加时 z-index 递增——用一个模块级计数器
let seed = 0; const zIndex = ++seed,或用provide全局管理栈。 - 嵌套与「只关最上面一层」:维护一个全局栈,
keydown Esc只关栈顶;遮罩点击也只关栈顶。 - 焦点与无障碍:打开时记录
document.activeElement,把焦点移到 Modal 内第一个可聚焦元素;关闭时还原;Esc关闭;内容区tabindex="-1";role="dialog"+aria-modal;Tab 循环限定在 Modal 内(focus trap)。 - 滚动锁定:打开时给
body加overflow: hidden并补偿滚动条宽度,避免页面抖动;关闭时恢复(要处理多 Modal 叠加的计数)。 - 挂载位置:
Teleport to="body",避免父组件transform/filter/overflow破坏 fixed 定位与层叠上下文。 - 命令式调用(可选):提供
useModal()返回open(options),内部h(Modal, props)+render(vnode, container),关闭时render(null, container)并移除容器,适合「弹一次就走」的场景(如确认框),避免到处写v-if。 - 销毁策略:
destroyOnClose用v-if控制内容,否则用v-show保留状态;表单类 Modal 建议每次打开重置(v-if或resetFields)。 - SSR 兼容:
Teleport目标需存在,document只在客户端访问(onMounted后)。 - 性能:Modal 内容用
v-if懒渲染;关闭后不保留大列表;动画用transform/opacity而非height。
4. 对外 API
v-model控制显隐;@ok/@cancel业务回调;okLoading、okDisabled支持异步提交;- 插槽:
default(内容)、header/footer(自定义标题与按钮); - 组合式
useModal用于命令式弹窗,与组件式共存。
5. 测试点
显隐、动画结束事件、遮罩/Esc 关闭、按钮回调、z-index 叠加、焦点还原、body 滚动锁定恢复、SSR 无 document 时不崩。