Drawer 抽屉
uni-appH5微信小程序App
跨端抽屉。从屏幕边缘(左/右/上/下)滑出的面板,带遮罩,bottom 模式顶部大圆角,移动端友好。
何时使用
需要承载较多内容但不离开当前页:筛选面板、详情侧滑、移动端底部操作面板。
何时不使用
简短确认用 Dialog;系统被动通知用 Notification。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
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() 后才真正关闭 |
zIndex | number | 1001 | 遮罩层 z-index,面板为 zIndex + 1 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 显隐变化(v-model) |
close | void | 任一途径触发关闭时触发 |
open | void | 打开时触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 抽屉正文(scroll-view 可滚动) |
title | 自定义标题区 |
footer | 底部操作区 |
示例
右侧抽屉
vue
<Button variant="primary" @click="visible = true">右侧打开</Button>
<Drawer v-model="visible" title="筛选">
<Stack :gap="12">
<Checkbox v-model="r1" label="仅看有货" />
<Checkbox v-model="r2" label="仅看自营" />
</Stack>
</Drawer>左侧与底部
vue
<view class="row">
<Button variant="secondary" @click="visible2 = true">左侧</Button>
<Button variant="ghost" @click="visible3 = true">底部</Button>
</view>
<Drawer v-model="visible2" title="菜单" placement="left" size="280px">
<Cell title="首页" arrow />
<Cell title="订单" arrow />
</Drawer>
<Drawer v-model="visible3" title="详情" placement="bottom" size="40%">
<Text variant="secondary">底部抽屉适合承载详情与表单。</Text>
</Drawer>遮罩不可关闭
vue
<Button variant="ghost" @click="visible4 = true">强确认抽屉</Button>
<Drawer v-model="visible4" title="完善资料" :mask-closable="false">
<Input v-model="name" label="昵称" placeholder="请输入昵称" />
</Drawer>