跳到主要内容

Drawer 抽屉 ​

uni-appH5微信小程序App

跨端抽屉。从屏幕边缘(左/右/上/下)滑出的面板,带遮罩,bottom 模式顶部大圆角,移动端友好。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Drawer 抽屉 · uni-app H5 实时运行 新窗口打开

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() 后才真正关闭
zIndexnumber1001遮罩层 z-index,面板为 zIndex + 1

Events ​

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

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>