使用抽屉式导航组件创建滑入式菜单

The 抽屉式导航 组件是一个滑入式菜单,可让用户导航到您应用的不同部分。用户可以通过从侧边滑动或点按菜单图标来激活它。

实现抽屉式导航的三个用例考虑因素

  • 内容组织:让用户可以在不同类别之间切换,例如在新闻或博客应用中。
  • 账号管理:在包含用户账号的应用中,提供账号设置和个人资料部分的快速链接。
  • 功能发现:在一个菜单中组织多个功能和设置,以便在复杂的应用中方便用户发现和访问。

在 Material Design 中,有两种类型的抽屉式导航

  • 标准抽屉式导航:与屏幕中的其他内容共享空间。
  • 模态抽屉式导航:出现在屏幕中其他内容的顶部。

版本兼容性

此实现要求您的项目 minSDK 设置为 API 级别 21 或更高。

依赖项

实现抽屉式导航

您可以使用 ModalNavigationDrawer 可组合项来实现抽屉式导航

要点

  • 使用 drawerContent 槽提供 ModalDrawerSheet 并提供抽屉的内容。

  • ModalNavigationDrawer 接受许多额外的抽屉参数。例如,您可以使用 gesturesEnabled 参数切换抽屉是否响应拖动,示例如下

控制抽屉式导航行为

要控制抽屉的打开和关闭方式,请使用 DrawerState

要点

  • 使用 drawerState 参数将 DrawerState 传递给 ModalNavigationDrawer
  • DrawerState 提供对 openclose 函数的访问权限,以及与当前抽屉状态相关的属性。这些挂起函数需要一个 CoroutineScope,您可以使用 rememberCoroutineScope 实例化它。您还可以根据 UI 事件调用这些挂起函数。

结果

图 1. 标准抽屉式导航(左)和模态抽屉式导航(右)。

包含本指南的集合

本指南是以下精选快速指南集合的一部分,这些集合涵盖了更广泛的 Android 开发目标

了解可组合函数如何让您轻松创建基于 Material Design 设计系统的精美 UI 组件。

有疑问或反馈?

前往我们的常见问题解答页面,了解快速指南,或联系我们,告诉我们您的想法。