uView Drawer 抽屉

本文主要是介绍uView Drawer 抽屉，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

有些时候, Dialog 组件并不满足我们的需求, 比如你的表单很长, 亦或是你需要临时展示一些文档, Drawer 拥有和 Dialog 几乎相同的 API, 在 UI 上带来不一样的体验.

TIP

在 Vue 3 之后的版本 v-model 可以用于任何一个组件，visible.sync 已被移除，请使用 v-model="visibilityBinding" 来控制抽屉组件的显示和隐藏状态。

TIP

在 SSR 场景下，您需要将组件包裹在 <client-only></client-only> 之中 (如: Nuxt) 和 SSG (例如: VitePress).

基础用法#

呼出一个临时的侧边栏, 可以从多个方向呼出

你必须像 Dialog一样为 Drawer 设置 model-value 属性来控制 Drawer 的显示与隐藏状态，该属性接受一个 boolean 类型。 Drawer 包含三部分: title & body & footer, 其中 title 是一个具名 slot, 你还可以通过 title 属性来设置标题, 默认情况下它是一个空字符串, 其中 body 部分是 Drawer 组件的主区域, 它包含了用户定义的主要内容. footer和title用法一致, 用来显示页脚信息. 当 Drawer 打开时，默认设置是从右至左打开 30% 浏览器宽度。你可以通过传入对应的 direction 和 size 属性来修改这一默认行为。下面一个示例将展示如何使用 before-close API，更多详细用法请参考页面底部的 API 部分。

left to rightright to lefttop to bottombottom to top

openwith footer

不添加 Title#

当你不需要标题的时候，你可以将它移除。

通过设置 with-header 属性为 false 来控制是否显示标题。如果你的应用需要具备可访问性，请务必设置好 title。

open

自定义内容#

像 Dialog 组件一样，Drawer 也可以用来显示多种不同的交互。

Open Drawer with nested tableOpen Drawer with nested form

自定义头部#

header 可用于自定义显示标题的区域。为了保持可用性，除了使用此插槽外，使用 title 属性，或使用 titleId 插槽属性来指定哪些元素应该读取为抽屉标题。

Open Drawer with customized header

嵌套抽屉#

你可以像 Dialog 一样拥有多层嵌套的 Drawer

如果你需要在不同图层中多个抽屉，你必须设置 append-to-body 属性到 true

open

TIP

Drawer 的内容是懒渲染的，即在第一次被打开之前，传入的默认 slot 不会被渲染到 DOM 上。因此，如果需要执行 DOM 操作，或通过 ref 获取相应组件，请在 open 事件回调中进行。

TIP

Drawer 还提供一个 destroy-on-close 的 API，用来控制是否在 Drawer 隐藏之后把 Drawer 的默认插槽内的内容销毁。当你需要每次打开抽屉都要调用 mounted 生命周期时，可以使用此 API。

API#

属性#

属性名	说明	类型	默认值
model-value / v-model	是否显示 Drawer	`boolean`	false
append-to-body	Drawer 自身是否插入至 body 元素上。嵌套的 Drawer 必须指定该属性并赋值为 true	`boolean`	false
lock-scroll	是否在 Drawer 出现时将 body 滚动锁定	`boolean`	true
before-close	关闭前的回调，会暂停 Drawer 的关闭	`Function`	—
close-on-click-modal	是否可以通过点击 modal 关闭 Drawer	`boolean`	true
close-on-press-escape	是否可以通过按下 ESC 关闭 Drawer	`boolean`	true
open-delay	Drawer 打开的延时时间，单位毫秒	`number`	0
close-delay	Drawer 关闭的延时时间，单位毫秒	`number`	0
custom-class deprecated	Drawer 的自定义类名	`string`	—
destroy-on-close	控制是否在关闭 Drawer 之后将子元素全部销毁	`boolean`	false
modal	是否需要遮罩层	`boolean`	true
direction	Drawer 打开的方向	`enum`	rtl
show-close	是否显示关闭按钮	`boolean`	true
size	Drawer 窗体的大小, 当使用 `number` 类型时, 以像素为单位, 当使用 `string` 类型时, 请传入 'x%', 否则便会以 `number` 类型解释	`number` \	`string`
title	Drawer 的标题，也可通过具名 slot （见下表）传入	`string`	—
with-header	控制是否显示 header 栏, 默认为 true, 当此项为 false 时, title attribute 和 title slot 均不生效	`boolean`	true
modal-class	遮罩层的自定义类名	`string`	—
z-index	设置 z-index	`number`	—
header-aria-level a11y	header 的 `aria-level` 属性	`string`	2

WARNING

custom-class 已被弃用，将会于 2.3.0 移除, 请使用 class。

事件#

插槽名	说明	类型
open	Drawer 打开的回调	`Function`
opened	Drawer 打开动画结束时的回调	`Function`
close	Drawer 关闭的回调	`Function`
closed	Drawer 关闭动画结束时的回调	`Function`

插槽#

名称	说明
default	Drawer 的内容
header	Drawer 标题的内容；会替换标题部分，但不会移除关闭按钮。
title deprecated	与 header 作用相同请使用 header
footer	Drawer 页脚部分