用 ref 控制侧边栏抽屉需按框架区分:element plus 用 ref 绑定 el-drawer 实例并调用 open/close 方法;uni-app 中 uni-drawer 必须通过 drawerref.value.open() 调用;自定义组件配合 v-model 双向绑定;app 端需拦截 onbackpress 防退出。

用 ref 控制侧边栏抽屉的呼出状态,核心是让 ref 指向抽屉组件实例,并调用其 open / close 方法——但具体写法取决于你用的是原生实现、uni-app 插件,还是 Element Plus 的 el-drawer。
Vue 3 + Element Plus el-drawer:ref 指向组件实例
el-drawer 支持 v-model 控制显隐,但若需手动触发(比如点击按钮后延迟打开),推荐用 ref 获取实例并调用方法:
- 模板中用
ref="drawerRef"绑定,不要加v-model(二者冲突) - 脚本中用
const drawerRef = ref(null)声明,onMounted后才能安全调用drawerRef.value.open()或.close() - 注意:el-drawer 的 open/close 是实例方法,不是属性;直接改
v-model对应的变量也能控制,但 ref 方式更主动、适合复杂逻辑
uni-app uni-drawer:ref 必须配合 .value.open() 调用
uni-drawer 不是内置组件,属于插件市场组件,ref 使用有明确约束:
- Vue 3 项目中必须用
ref()声明,且调用时写成drawerRef.value.open()——漏掉.value会报Cannot read property 'open' of undefined - 如果用了
<script setup></script>,确保组件没被封装成无 expose 的黑盒;自定义封装时要defineExpose({ open, close }) -
width属性必须传字符串,例如:width="'300rpx'",传数字 300 会导致宽度为 0
自定义抽屉组件:ref 配合 v-model 双向绑定
如果你自己写的 CustomDrawer 组件支持 v-model:modelValue,ref 主要用于触发或监听状态,而非直接操作 DOM:
- 声明
const drawerVisible = ref(false),模板中写v-model:modelValue="drawerVisible" - 想用 ref 控制,就直接改
drawerVisible.value = true;组件内部应通过defineModel正确响应 - 需要在打开前清空表单?用
@before-open或watchEffect监听drawerVisible变化即可
移动端物理返回键拦截(App 端必做)
仅靠 ref 控制打开关闭还不够,App 端用户按返回键时需主动干预:
- 在页面中定义
onBackPress生命周期钩子 - 判断
drawerRef.value?.isOpen === true(或你自己维护的 visible 状态),若是则调用drawerRef.value?.close()并 return true - 不拦截的话,用户一按返回键整个 App 就退出了
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










