Vue 3 中用 ref 控制弹窗显隐的核心是父组件直接调用子组件暴露的 open()/close() 方法；子组件需用 ref 管理 visible 状态、封装方法并 defineExpose 暴露，父组件通过模板 ref 绑定后调用，支持可中断、易调试的交互流程。
Vue 3 中用 ref 控制弹窗显隐，核心是让父组件能直接调用子组件内部的方法（如 open()、close()），而不是仅靠 props 或 v-model 被动响应。这种方式更灵活、可中断、易调试，也符合组合式 API 的设计习惯。
子组件必须暴露控制方法
子组件（如 Modal.vue）需在 setup 中定义显隐逻辑，并通过 defineExpose 主动暴露方法：
- 用
ref管理内部visible状态，比如const visible = ref(false) - 封装
open()、close()或toggle(show?: boolean)方法 - 必须写
defineExpose({ open, close })，否则父组件的 ref 拿不到这些函数 - 不要只依赖
v-model:visible或:visible.sync，它们无法支持“请求中手动关闭”“条件性隐藏”等场景
父组件通过 ref 调用子组件方法
父组件使用模板 ref 绑定子组件实例，再在逻辑中触发方法：
vue-admin-change-reviewer
下载
审查 Vue 管理后台的变更请求（Vue 2 + Element UI，Vue 3 + Element Plus）。重点关注最小化变更实现、上线风险检查以及回归检查清单生成。
- 模板中加
ref="modalRef"：<modalcomponent ref="modalRef"></modalcomponent> - setup 中声明同名 ref：
const modalRef = ref() - 需要时调用：
modalRef.value?.open()或modalRef.value?.close() - 加可选链
?.防止组件尚未挂载时报错 - 适合放在 API 请求前后：
modalRef.value?.open()→await api()→modalRef.value?.close()
样式与定位不能忽略
弹窗要准确覆盖目标区域，需注意 DOM 层级和 CSS 行为：
立即学习“前端免费学习笔记（深入）”；
- 包裹弹窗的父容器建议设
position: relative，否则position: absolute的弹窗会相对于 body 定位，容易偏移 - 弹窗自身设
position: absolute; top: 0; left: 0; width: 100%; height: 100% -
z-index至少设为999，避免被导航栏、固定按钮等遮挡 - 如果弹窗含遮罩层（mask），遮罩建议用
background: rgba(0,0,0,0.5)+backdrop-filter: blur(2px)提升质感
不推荐的替代方案
以下方式虽能实现基础显隐，但在复杂交互中容易失控：
- 纯 v-if/v-show 控制：状态全由父组件 data/ref 驱动，子组件无自主权，无法在内部拦截关闭（比如表单未保存时弹确认）
- props + emit 双向绑定：需父子频繁同步，watch 处理多、易出竞态，且无法支持“子组件主动打开”（如按钮点击后自动弹窗）
- 全局状态管理（如 pinia）：过度设计，一个弹窗没必要上升到全局状态，增加耦合与调试成本
