NavController

KEY_DEEP_LINK_INTENT

@NonNull static val KEY_DEEP_LINK_INTENT: String

The Intent that triggered a deep link to the current destination.

Value: "android-support-nav:controller:deepLinkIntent"

<init>

NavController(@NonNull context: Context)

Constructs a new controller for a given Context. Controllers should not be used outside of their context and retain a hard reference to the context supplied. If you need a global controller, pass Context#getApplicationContext().

Apps should generally not construct controllers, instead obtain a relevant controller directly from a navigation host via NavHost#getNavController() or by using one of the utility methods on the Navigation class.

Note that controllers that are not constructed with an Activity context (or a wrapped activity context) will only be able to navigate to new tasks or new document tasks when navigating to new activities.

addOnDestinationChangedListener

open fun addOnDestinationChangedListener(@NonNull listener: NavController.OnDestinationChangedListener): Unit

Adds an OnDestinationChangedListener to this controller to receive a callback whenever the getCurrentDestination() or its arguments change.

The current destination, if any, will be immediately sent to your listener.

createDeepLink

@NonNull open fun createDeepLink(): NavDeepLinkBuilder

Create a deep link to a destination within this NavController.

getBackStackEntry

@NonNull open fun getBackStackEntry(@IdRes destinationId: Int): NavBackStackEntry

Gets the topmost NavBackStackEntry for a destination id.

This is always safe to use with the current destination or its parent or grandparent navigation graphs as these destinations are guaranteed to be on the back stack.

getCurrentBackStackEntry

@Nullable open fun getCurrentBackStackEntry(): NavBackStackEntry?

Gets the topmost NavBackStackEntry.

getCurrentDestination

@Nullable open fun getCurrentDestination(): NavDestination?

Gets the current destination.

getGraph

@NonNull open fun getGraph(): NavGraph

Gets the topmost navigation graph associated with this NavController.

getNavInflater

@NonNull open fun getNavInflater(): NavInflater

Returns the inflater for this controller.

getNavigatorProvider

@NonNull open fun getNavigatorProvider(): NavigatorProvider

Retrieve the NavController's NavigatorProvider. All Navigators used to construct the navigation graph for this nav controller should be added to this navigator provider before the graph is constructed.

Generally, the Navigators are set for you by the NavHost hosting this NavController and you do not need to manually interact with the navigator provider.

getPreviousBackStackEntry

@Nullable open fun getPreviousBackStackEntry(): NavBackStackEntry?

Gets the previous visible NavBackStackEntry.

This skips over any NavBackStackEntry that is associated with a NavGraph.

getViewModelStoreOwner

@NonNull open fun getViewModelStoreOwner(@IdRes navGraphId: Int): ViewModelStoreOwner

Gets the ViewModelStoreOwner for a NavGraph. This can be passed to androidx.lifecycle.ViewModelProvider to retrieve a ViewModel that is scoped to the navigation graph - it will be cleared when the navigation graph is popped off the back stack.

handleDeepLink

open fun handleDeepLink(@Nullable intent: Intent?): Boolean

Checks the given Intent for a Navigation deep link and navigates to the deep link if present. This is called automatically for you the first time you set the graph if you've passed in an Activity as the context when constructing this NavController, but should be manually called if your Activity receives new Intents in Activity#onNewIntent(Intent).

The types of Intents that are supported include:

Intents created by NavDeepLinkBuilder or createDeepLink(). This assumes that the current graph shares the same hierarchy to get to the deep linked destination as when the deep link was constructed.
Intents that include a data Uri. This Uri will be checked against the Uri patterns in the NavDeepLinks added via NavDestination#addDeepLink(NavDeepLink).

The navigation graph should be set before calling this method.

navigate

open fun navigate(@IdRes resId: Int): Unit

Navigate to a destination from the current navigation graph. This supports both navigating via an action and directly navigating to a destination.

navigate

open fun navigate(
    @IdRes resId: Int, 
    @Nullable args: Bundle?
): Unit

Navigate to a destination from the current navigation graph. This supports both navigating via an action and directly navigating to a destination.

navigate

open fun navigate(
    @IdRes resId: Int, 
    @Nullable args: Bundle?, 
    @Nullable navOptions: NavOptions?
): Unit

Navigate to a destination from the current navigation graph. This supports both navigating via an action and directly navigating to a destination.

navigate

open fun navigate(
    @IdRes resId: Int, 
    @Nullable args: Bundle?, 
    @Nullable navOptions: NavOptions?, 
    @Nullable navigatorExtras: Navigator.Extras?
): Unit

Navigate to a destination from the current navigation graph. This supports both navigating via an action and directly navigating to a destination.