Skip to content

Drawer 抽屉

从屏幕边缘滑出的浮层面板。

基本用法

通过 v-model 控制显示/隐藏,默认从右侧滑出。

vue
<script setup>
import { ref } from 'vue'
const show = ref(false)
</script>

<ABtn @click="show = true">右侧抽屉</ABtn>
<ADrawer v-model="show" title="抽屉标题">
  这是抽屉的内容区域。
</ADrawer>

左侧滑出

设置 placement="left" 从左侧滑出。

vue
<ADrawer v-model="show" placement="left" title="左侧抽屉">
  内容
</ADrawer>

API

Props

名称类型默认值说明
modelValuebooleanfalse是否显示
placement'left' | 'right' | 'top' | 'bottom''right'滑出方向
widthstring'300px'左右抽屉宽度
heightstring'300px'上下抽屉高度
titlestring标题
closablebooleantrue是否显示关闭按钮
maskClosablebooleantrue点击遮罩是否关闭

Events

名称说明
update:modelValue显示状态变化
open打开时触发
close关闭时触发

Slots

名称说明
default主体内容
header自定义顶部区域

交互特性

  • 遮罩淡入 + 面板 ease-out 侧滑
  • 点击遮罩关闭
  • Esc 键关闭
  • 打开时锁定 body 滚动

MIT License