Skip to content

抽屉组件

抽屉组件

抽屉组件是一种从屏幕边缘滑出的浮层面板,用于展示临时的内容或操作区域,常用于侧边导航、设置面板、详情查看等场景,适合需要快速访问但不打断主页面浏览的内容展示。

基础用法

基础的抽屉组件用法,默认从左侧弹出,包含标题、内容和底部按钮区域。

显示代码箭头
复制GitHub

弹出方向

抽屉组件支持从四个方向弹出:左、右、上、下,适应不同的交互场景。

显示代码箭头
复制GitHub

尺寸和样式

可以自定义抽屉的尺寸、内边距、阴影和偏移等样式属性。

尺寸设置

内边距

偏移设置

显示代码箭头
复制GitHub

按钮配置

可以自定义底部按钮的文本、类型、对齐方式,或者完全隐藏底部按钮区域和关闭图标。

显示代码箭头
复制GitHub

交互配置

抽屉组件提供了多种交互配置选项,如是否显示遮罩层、点击遮罩层是否关闭、按ESC键是否关闭、是否限制最大高度等。

交互配置选项

控制抽屉背景是否显示遮罩层
控制点击遮罩层是否可以关闭抽屉
控制按ESC键是否可以关闭抽屉
控制是否限制抽屉的最大高度(适用于左右方向)
显示代码箭头
复制GitHub

自定义内容

通过插槽可以自定义抽屉的标题、内容和底部区域,实现更灵活的布局和样式。

显示代码箭头
复制GitHub

事件处理

抽屉组件提供了一系列事件,用于监听抽屉的打开、关闭和交互状态。

显示代码箭头
复制GitHub

抽屉 API

TDrawer 属性

属性名说明类型可选值默认值
modelValue是否显示抽屉(双向绑定)booleanfalse
title抽屉标题string
position抽屉弹出方向stringleft/right/top/bottomleft
size抽屉尺寸string600px
icon标题图标stringinspiration
padding内边距array/number[12, 16, 12, 16]
box-shadow阴影设置array
is-modal是否显示遮罩层booleantrue
close-on-press-model点击遮罩是否关闭抽屉booleantrue
close-on-press-escape按ESC是否关闭抽屉booleantrue
is-close-icon是否显示关闭图标booleantrue
is-foot是否显示底部按钮booleantrue
is-set-max-height是否设置最大高度booleantrue
confirm-text确认按钮文本string确定
cancel-text取消按钮文本string取消
confirm-type确认按钮类型stringprimary/success/warning/danger/infoprimary
cancel-type取消按钮类型stringprimary/success/warning/danger/infodefault
btn-align按钮对齐方式stringflex-start/center/flex-endflex-end
offset偏移位置object{ x: 0, y: 0 }

事件

事件名说明回调参数
open抽屉打开时触发
close抽屉关闭时触发
confirm点击确认按钮时触发
cancel点击取消按钮时触发

插槽

插槽名说明作用域参数
default抽屉的内容
title自定义标题区域内容
footer抽屉底部操作区内容

样式变量

变量名说明
$drawer-bg-color抽屉背景色
$drawer-border-radius抽屉圆角
$drawer-header-height抽屉标题栏高度
$drawer-header-color抽屉标题文字颜色
$drawer-content-color抽屉内容文字颜色
$drawer-footer-height抽屉底部区域高度
$drawer-shadow抽屉阴影
</rewritten_file>

基于MIT许可发布