Navigation refers to the interactions that allow users to navigate across, into, and back out from the different pieces of content within your app. Android Jetpack's Navigation component helps you implement navigation, from simple button clicks to more complex patterns, such as app bars and the navigation drawer. The Navigation component also ensures a consistent and predictable user experience by adhering to an established set of principles.
The Navigation component consists of three key parts that are described below:
- Navigation graph: An XML resource that contains all navigation-related information in one centralized location. This includes all of the individual content areas within your app, called destinations, as well as the possible paths that a user can take through your app.
NavHost
: An empty container that displays destinations from your navigation graph. The Navigation component contains a defaultNavHost
implementation,NavHostFragment
, that displays fragment destinations.NavController
: An object that manages app navigation within aNavHost
. TheNavController
orchestrates the swapping of destination content in theNavHost
as users move throughout your app.
As you navigate through your app, you tell the NavController
that you want to
navigate either along a specific path in your navigation graph or directly to a
specific destination. The NavController
then shows the appropriate destination
in the NavHost
.
The Navigation component provides a number of other benefits, including the following:
- Handling fragment transactions.
- Handling Up and Back actions correctly by default.
- Providing standardized resources for animations and transitions.
- Implementing and handling deep linking.
- Including Navigation UI patterns, such as navigation drawers and bottom navigation, with minimal additional work.
- Safe Args - a Gradle plugin that provides type safety when navigating and passing data between destinations.
ViewModel
support - you can scope aViewModel
to a navigation graph to share UI-related data between the graph's destinations.
In addition, you can use Android Studio's Navigation Editor to view and edit your navigation graphs.
Next steps
For more documentation and resources related to the Navigation component, see the following.
Getting started
Further topics
- Principles of Navigation
- Design for different form factors
- Gesture navigation
- Design navigation graphs
- Nested graphs
- Global actions
- Conditional navigation
- Pass data between destinations
- Create a deep link for a destination
- Animate transitions between destinations
- Update UI components with NavigationUI
- Create swipe views with tabs
- Interact programmatically with the Navigation component
- Test navigation
- Add new destination types
- Provide custom back navigation
- Migrate to the Navigation component
Samples
Codelabs
Blog posts
Videos
- Navigating Navigation
- 10 Best Practices for Moving to a Single Activity
- Single Activity: Why, When, and How (Android Dev Summit '18)
- Android Jetpack: Manage UI navigation with Navigation Controller (Google I/O '18)