← 返回完整题库
vue.js困难

如果使用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. 关键实现细节

  1. 显隐与动画:用 ref 控制 visible,Transition 做进出场;关闭时先播动画再 emit('update:modelValue', false)(或 destroyOnClose 时等 after-leave 再销毁内容)。
  2. 层级管理:多个 Modal 叠加时 z-index 递增——用一个模块级计数器 let seed = 0; const zIndex = ++seed,或用 provide 全局管理栈。
  3. 嵌套与「只关最上面一层」:维护一个全局栈,keydown Esc 只关栈顶;遮罩点击也只关栈顶。
  4. 焦点与无障碍:打开时记录 document.activeElement,把焦点移到 Modal 内第一个可聚焦元素;关闭时还原;Esc 关闭;内容区 tabindex="-1";role="dialog" + aria-modal;Tab 循环限定在 Modal 内(focus trap)。
  5. 滚动锁定:打开时给 body 加 overflow: hidden 并补偿滚动条宽度,避免页面抖动;关闭时恢复(要处理多 Modal 叠加的计数)。
  6. 挂载位置:Teleport to="body",避免父组件 transform/filter/overflow 破坏 fixed 定位与层叠上下文。
  7. 命令式调用(可选):提供 useModal() 返回 open(options),内部 h(Modal, props) + render(vnode, container),关闭时 render(null, container) 并移除容器,适合「弹一次就走」的场景(如确认框),避免到处写 v-if。
  8. 销毁策略:destroyOnClose 用 v-if 控制内容,否则用 v-show 保留状态;表单类 Modal 建议每次打开重置(v-if 或 resetFields)。
  9. SSR 兼容:Teleport 目标需存在,document 只在客户端访问(onMounted 后)。
  10. 性能: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 时不崩。

本题来自 计算机知识面试题库,共 921 道题。