Skip to content

Drawer 抽屉

从侧边滑出的面板,常用于筛选条件、详情信息等场景。

基础用法

右侧抽屉

打开右侧抽屉

从右侧滑出的面板内容,点击遮罩、关闭按钮或按 Esc 均可关闭。

左侧抽屉

左侧抽屉

打开左侧抽屉

状态:全部

分类:全部

排序:创建时间

禁止遮罩关闭

no-mask-close 禁止点击遮罩关闭抽屉(其他关闭入口保留)。

no-mask-close

打开抽屉

点击遮罩不会关闭,需通过 ✕ / Esc 或底部按钮关闭。

受控显示

visible 为受控属性:由宿主(按钮 / JS)设置或移除,组件不会自动恢复;关闭后可监听 oas-ok / oas-close 后移除 visible

受控显示(visible)

打开(设置 visible)关闭(移除 visible)

外部按钮直接设置 / 移除 visible 控制显隐,无需依赖底部按钮。

无底部按钮

无底部按钮

打开无按钮抽屉

隐藏底部操作区,仅保留 ✕ 与 Esc 关闭入口。

事件反馈

事件反馈

打开并监听事件

点击「确定」或「取消」,观察右上角消息提示。

自定义宽度

自定义宽度

打开 640px 抽屉

通过 width 属性指定抽屉宽度,支持 px 或百分比(如 50%),窄屏下受 max-width: 90vw 约束。

尺寸档位

尺寸档位

small(256px)large(736px)

small 档:256px,适合窄屏辅助信息。

large 档:736px,适合复杂表单或详情场景。

API

属性

属性说明类型默认值
no-footer隐藏底部操作按钮boolean
no-mask-close禁用点击遮罩关闭boolean
placement滑出方向stringright
size预设尺寸档位或具体值:small(256px)/ medium(378px)/ large(736px),或直接写如 512px40%
title标题文案string
visible是否显示boolean
width抽屉宽度(px 或百分比),优先级高于 size

事件

事件说明
oas-close关闭:取消按钮 / ✕ / 遮罩点击 / Esc
oas-ok点击「确定」

插槽

名称说明
默认

role="dialog" + aria-modal="true",打开时焦点移入关闭按钮,关闭后还原。