布局抽屉
QLayout 允许您将视图配置为一个 3x3 矩阵,其中包含可选的页眉/页脚(主要用于导航栏,但也可以是别的任何东西)。如果尚未准备好,请先阅读 QLayout 文档页面。
QDrawer 是 QLayout 的侧边栏部分。
QDrawer API
布局生成器
点击下面的按钮来搭建您的布局。
布局生成器launch用法
TIP
- 由于 QDrawer 需要布局,并且默认情况下 QLayout 会管理整个窗口,因此出于演示目的,我们将使用容器化的 QLayouts。 但是请记住,这不代表您也需要将容器化的 QLayouts 用于 QDrawer。
- 如果 QDrawer 内容也包含图像,并且您想使用触摸操作将其关闭,则可能要向其添加
draggable="false"
,否则本地浏览器的默认行为可能会产生负面影响。
WARNING
默认情况下,QDrawer 附带有触摸操作。 如果这干扰了您的侧滑菜单内容组件,请通过指定布尔值 no-swipe-close
属性来禁用它。
WARNING
当 QDrawer 设置为覆盖(overlay)模式时,QDrawer 将强制进入固定位置,无论 QLayout 的“view” 属性是否配置为 “l/r” 或 “L/R”。 另外,如果在 iOS 平台上并且 QLayout 已容器化,由于无法克服的平台限制,固定位置也将被强制置于 QDrawer 上。
基础
考虑将 QItems 与下面的路由属性(如 to
)一起使用。 出于演示目的,未添加这些属性,因为它将破坏 UMD 版本。
mini(迷您)模式
侧滑菜单可以在两种模式下运行:“正常” 和 “迷您”,您可以使用 QDrawer 上的布尔 mini
属性在它们之间进行切换。
WARNING
请注意,mini 模式在 mobile 行为(behavior)下不适用。
在处理 “mini” 模式时,有一些 CSS 类可以帮助您自定义侧滑菜单。尤其是在处理 “click” 触发器时,非常有用:
CSS 类名 | 描述 |
---|---|
q-mini-drawer-hide | 侧滑菜单处于 “mini” 或者 “mobile” 模式时隐藏。 |
q-mini-drawer-only | 仅在侧滑菜单处于 “mini” 模式时显示。 |
您还可以利用以下特性根据实际情况编写自己的 CSS 类:QLayoutDrawer 在 “normal” 模式下具有q-drawer--standard
CSS 类,在 “mini” 模式下具有 q-drawer--mini
。此外,当侧滑菜单处于"mobile" 行为时,它会获得 q-drawer--mobile
CSS 类。
鼠标移入/移出触发
考虑将 QItems 与下面的路由属性(如 to
)一起使用。 出于演示目的,未添加这些属性,因为它将破坏 UMD 版本。
迷您覆盖
不管您是否使用 view
属性进行配置,mini-to-overlay
布尔属性始终将您的侧滑菜单设置为固定位置,但仅在迷您模式下会占用布局上的空间。
点击触发迷您模式
在下面的示例中,当处于 “mini” 模式时,如果用户单击侧滑菜单,则我们将切换到普通模式。
考虑将 QItems 与下面的路由属性(如 to)一起使用。 出于演示目的,未添加这些属性,因为它将破坏 UMD 版本。
Slots
默认情况下,在 “mini” 模式下,Quasar CSS 隐藏一些 DOM 元素以提供整洁的狭窄侧滑菜单。 但是,肯定有一些用例需要您进行深度调整。您可以为此使用 QLayoutDrawe r 的 “mini” Vue 插槽。 在 “mini” 模式下,此插槽的内容将替换侧滑菜单的默认内容。
Overlay(覆盖)模式
overlay(覆盖)模式可防止侧滑菜单占用布局上的空间,而是将鼠标悬停在页面上。无论使用 view
属性的配置如何,这都将侧滑菜单始终固定在固定位置。
在下面的示例中,单击菜单图标以查看运行中的侧滑菜单。 最好在至少宽度为 500px 的窗口的桌面上查看(这是此演示中设置的断点)。