跳到主要内容

Drawer 抽屉 ​

WebH5

抽屉。从屏幕边缘(左/右/上/下)滑出的面板,带遮罩、Esc 关闭与 body 滚动锁定;bottom 模式顶部大圆角并适配安全区,移动端友好。

何时使用 ​

需要承载较多内容但不离开当前页:筛选面板、详情侧滑、移动端底部操作面板。

何时不使用 ​

简短确认用 Dialog;系统被动通知用 Notification。

Props ​

名称类型默认值说明
modelValuebooleanfalse显隐(v-model)
titlestring""标题,可被 title 插槽覆盖
placementstring:'left' | 'right' | 'top' | 'bottom'"right"滑出方向
sizestring"360px"尺寸:left/right 为宽度,top/bottom 为高度
maskClosablebooleantrue点击遮罩是否关闭
showClosebooleantrue是否显示右上角关闭按钮
beforeClose(done: () => void) => void-关闭前钩子:所有关闭途径先调用它,done() 后才真正关闭。多抽屉叠加时 z-index 由内部递增管理

Events ​

名称载荷说明
update:modelValueboolean显隐变化(v-model)
closevoid任一途径触发关闭时触发
openvoid打开时触发

Slots ​

名称说明
default抽屉正文
title自定义标题区
footer底部操作区

示例 ​

基础(右侧滑出) ​

示例加载中…

底部抽屉(移动端) ​

示例加载中…

左侧导航 ​

示例加载中…

顶部滑出 ​

示例加载中…

禁止遮罩关闭 ​

示例加载中…

自定义标题插槽 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Drawer 文档(含手机预览)。