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

该 导航抽屉 组件是一个滑入菜单，使用户可以导航到应用的不同部分。用户可以通过从侧面滑动或点击菜单图标来激活它。

考虑实施导航抽屉的这三种用例

  • 内容组织：使用户能够在不同的类别之间切换，例如在新闻或博客应用中。
  • 帐户管理：在具有用户帐户的应用中，提供指向帐户设置和个人资料部分的快速链接。
  • 功能发现：在单个菜单中组织多个功能和设置，以方便用户在复杂应用中发现和访问这些功能。

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

  • 标准：与其他内容共享屏幕内的空间。
  • 模态：显示在屏幕内其他内容的顶部。

版本兼容性

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

依赖项

实现导航抽屉

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

要点

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

  • ModalNavigationDrawer 接受许多其他抽屉参数。例如，您可以使用 gesturesEnabled 参数切换抽屉是否响应拖动，如下例所示

控制导航抽屉行为

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

要点

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

结果

图 1. 标准导航抽屉（左）和模态导航抽屉（右）。

包含本指南的收藏集

本指南是这些精选的快速指南收藏集的一部分，涵盖了更广泛的 Android 开发目标

了解可组合函数如何使您能够轻松创建基于 Material Design 设计系统的精美 UI 组件。
快速指南收藏集

有问题或反馈吗？

访问我们的常见问题页面，了解快速指南，或与我们联系，告诉我们您的想法。
访问常见问题解答 留下反馈