抽屉 Drawer

屏幕边缘滑出的浮层面板,用于承载临时内容或操作。

何时使用

  • 需要从屏幕边缘滑出一个面板来承载内容
  • 用于移动端或空间受限的场景
  • 替代 Modal 对话框,提供更自然的过渡效果

示例

基础用法

最简单的用法,从右侧滑出抽屉。

正在加载组件...
code

不同方向

支持从上、右、下、左四个方向滑出。

正在加载组件...
code

自定义尺寸

可以自定义抽屉的宽度(左右方向)或高度(上下方向)。

正在加载组件...
code

移动端模式

为移动端优化的抽屉样式,提供更好的用户体验。

正在加载组件...
code

无底部抽屉

通过 showFooter 属性隐藏底部操作栏。

正在加载组件...
code

表单抽屉

在抽屉中放置表单,常用于新建或编辑操作。

正在加载组件...
code

API

Drawer

参数说明类型默认值
open是否显示抽屉booleanfalse
title标题ReactNode-
placement抽屉方向'top' | 'right' | 'bottom' | 'left''right'
closable是否显示关闭按钮booleantrue
closeByOverlay点击蒙层是否可以关闭booleantrue
onClose关闭时的回调() => void-
onOk点击确认按钮的回调() => void-
width抽屉宽度(左右方向时有效)number | string378
height抽屉高度(上下方向时有效)number | string378
footer自定义 footer,设置为 null 则不显示ReactNode | null-
showFooter是否显示 footerbooleantrue
okText确认按钮文字string'确定'
cancelText取消按钮文字string'取消'
okButtonProps确认按钮属性Omit<ButtonProps, 'children' | 'onClick'>-
cancelButtonProps取消按钮属性Omit<ButtonProps, 'children' | 'onClick'>-
showCancel是否显示取消按钮booleantrue
isMobile是否为移动端模式booleanfalse
children子元素(正文内容)ReactNode-
className自定义类名string-
afterOpenChange打开/关闭动画完成后的回调(open: boolean) => void-