Drawer 抽屉
WebH5
抽屉。从屏幕边缘(左/右/上/下)滑出的面板,带遮罩、Esc 关闭与 body 滚动锁定;bottom 模式顶部大圆角并适配安全区,移动端友好。
何时使用
需要承载较多内容但不离开当前页:筛选面板、详情侧滑、移动端底部操作面板。
何时不使用
简短确认用 Dialog;系统被动通知用 Notification。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 显隐(v-model) |
title | string | "" | 标题,可被 title 插槽覆盖 |
placement | string:'left' | 'right' | 'top' | 'bottom' | "right" | 滑出方向 |
size | string | "360px" | 尺寸:left/right 为宽度,top/bottom 为高度 |
maskClosable | boolean | true | 点击遮罩是否关闭 |
showClose | boolean | true | 是否显示右上角关闭按钮 |
beforeClose | (done: () => void) => void | - | 关闭前钩子:所有关闭途径先调用它,done() 后才真正关闭。多抽屉叠加时 z-index 由内部递增管理 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 显隐变化(v-model) |
close | void | 任一途径触发关闭时触发 |
open | void | 打开时触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 抽屉正文 |
title | 自定义标题区 |
footer | 底部操作区 |
示例
基础(右侧滑出)
示例加载中…
底部抽屉(移动端)
示例加载中…
左侧导航
示例加载中…
顶部滑出
示例加载中…
禁止遮罩关闭
示例加载中…
自定义标题插槽
示例加载中…
Playground
加载中…
right
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Drawer 文档(含手机预览)。