NavGraphNavigator
kotlin.Any
   ↳ androidx.navigation.Navigator
     ↳ androidx.navigation.NavGraphNavigator
Known direct subclasses
DynamicGraphNavigator

Navigator for graphs in dynamic feature modules.

A Navigator built specifically for NavGraph elements. Handles navigating to the correct destination when the NavGraph is the target of navigation actions.

Construct a Navigator capable of routing incoming navigation requests to the proper destination within a NavGraph.

Summary

Public constructors
Cmn

Public functions
open NavGraph

Creates a new NavGraph associated with this navigator.
Cmn
open Unit
navigate(
    entries: List<NavBackStackEntry>,
    navOptions: NavOptions?,
    navigatorExtras: Navigator.Extras?
)
Cmn

Public properties
StateFlow<List<NavBackStackEntry>>

Gets the backstack of NavBackStackEntry associated with this Navigator
Cmn

Inherited functions
From androidx.navigation.Navigator
open NavDestination?
navigate(
    destination: NavGraph,
    args: SavedState?,
    navOptions: NavOptions?,
    navigatorExtras: Navigator.Extras?
)

Navigate to a destination.
Cmn
open Unit

Indicator that this Navigator is actively being used by a NavController.
Cmn
open Unit

Informational callback indicating that the given backStackEntry has been affected by a NavOptions.shouldLaunchSingleTop operation.
Cmn
open Unit

Restore any state previously saved in onSaveState.
Cmn
open SavedState?

Called to ask for a SavedState representing the Navigator's state.
Cmn
open Boolean

Attempt to pop this navigator's back stack, performing the appropriate navigation.
Cmn
open Unit
popBackStack(popUpTo: NavBackStackEntry, savedState: Boolean)

Attempt to pop this navigator's back stack, performing the appropriate navigation.
Cmn

Inherited properties
From androidx.navigation.Navigator
Boolean

Whether this Navigator is actively being used by a NavController.
Cmn
NavigatorState

The state of the Navigator is the communication conduit between the Navigator and the NavController that has called onAttach.
Cmn

Public constructors

Cmn
Added in 1.0.0
NavGraphNavigator(navigatorProvider: NavigatorProvider)
Parameters
navigatorProvider: NavigatorProvider

NavigatorProvider used to retrieve the correct Navigator to navigate to the start destination

Public functions

createDestination

Cmn 
open fun createDestination(): NavGraph

Creates a new NavGraph associated with this navigator.

Returns
NavGraph

The created NavGraph.
Cmn 
open fun navigate(
    entries: List<NavBackStackEntry>,
    navOptions: NavOptions?,
    navigatorExtras: Navigator.Extras?
): Unit
Throws
kotlin.IllegalArgumentException

if given destination is not a child of the current navgraph

Public properties

backStack

Cmn
Added in 2.6.0
val backStack: StateFlow<List<NavBackStackEntry>>

Gets the backstack of NavBackStackEntry associated with this Navigator