3.1 KiB
3.1 KiB
Drawer 抽屉
示例
位置
使用 placement 属性控制抽屉弹出的位置。
模态与非模态
使用 modal 属性控制抽屉是否为模态类型。
自定义内容
API
属性
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
ui |
string= |
- | [^ui] |
placement |
string |
'right' |
[^placement] |
modal |
boolean |
true |
是否是模态抽屉。模态抽屉默认遮挡底层（无法点击）且抢占焦点（关闭后焦点会回归）。 |
title |
string |
- | 抽屉标题文本。如果指定了 title 插槽，则优先使用 title 插槽。 |
open |
boolean |
false |
[^open] |
closable |
boolean |
true |
是否显示关闭按钮。 |
outside-closable |
boolean |
false |
点击抽屉外部时是否关闭抽屉。 |
draggable |
boolean |
false |
是否可拖拽。 |
escapable |
boolean |
false |
按下 esc 键是否可以关闭抽屉。仅在 closable 为 true 时生效。 |
footless |
boolean |
false |
是否不显示默认的底部操作栏。 |
before-close |
`function(string): boolean= | Promise<boolean=>` | - |
overlay-class |
`string | Object` | - |
^^^ui 预设样式。
+++枚举值
| 值 | 描述 |
|---|---|
s |
小内容尺寸（内容及部件尺寸，非抽屉整体空间大小）。 |
m |
中内容尺寸（内容及部件尺寸，非抽屉整体空间大小）。 |
| +++ | |
| ^^^ |
^^^placement 抽屉位置。
+++枚举值
| 值 | 描述 |
|---|---|
top |
从上面滑出。 |
right |
从右面滑出。 |
bottom |
从下面滑出。 |
left |
从左面滑出。 |
| +++ | |
| ^^^ |
^^^open
:::badges
.sync
:::
是否显示抽屉。 ^^^
插槽
| 名称 | 描述 |
|---|---|
default |
内容区。 |
title |
标题区。若同时指定了 title 属性和 title 插槽，以后者为准。 |
foot |
[^slot-foot] |
^^^slot-foot 底部区域，默认会展示“确定”、“取消”按钮。
+++作用域参数
| 名称 | 类型 | 描述 |
|---|---|---|
close |
function(type: string): void |
触发抽屉关闭的回调函数。type 为关闭的类型，将作为参数传入 before-close 钩子函数作为参数，同时将同步触发同名的事件。 |
| +++ | ||
| ^^^ |
事件
| 名称 | 描述 |
|---|---|
ok |
点击“确定”按钮时或通过调用作用域函数 close('ok') 时触发。 |
cancel |
点击“取消”按钮、关闭按钮、通过 esc 关闭抽屉时，或者通过调用作用域函数 close('cancel') 时触发。 |
| <value> | 通过调用作用域函数 close(value) 时触发。 |
afterclose |
浮层关闭后触发。如果样式主题提供了退出动画，将在退出动画完毕后触发。 |