ActivityNavigator



ActivityNavigator implements cross-activity navigation.

Summary

Nested types

NavDestination for activity navigation

Extras that can be passed to ActivityNavigator to customize what ActivityOptionsCompat and flags are passed through to the call to ActivityCompat.startActivity.

Builder for constructing new Extras instances.

Public companion functions

Unit

Apply any pop animations in the Intent of the given Activity to a pending transition.

android

Public constructors

android

Public functions

open ActivityNavigator.Destination
android
open NavDestination?
navigate(
    destination: ActivityNavigator.Destination,
    args: Bundle?,
    navOptions: NavOptions?,
    navigatorExtras: Navigator.Extras?
)

Navigate to a destination.

android
open Boolean
android

Inherited functions

From androidx.navigation.Navigator
open Unit
navigate(
    entries: List<NavBackStackEntry>,
    navOptions: NavOptions?,
    navigatorExtras: Navigator.Extras?
)
android
open Unit
android
open Unit
android
open Unit
onRestoreState(savedState: Bundle)
android
open Bundle?
android
open Unit
popBackStack(popUpTo: NavBackStackEntry, savedState: Boolean)
android

Inherited properties

From androidx.navigation.Navigator

Public companion functions

applyPopAnimationsToPendingTransition

fun applyPopAnimationsToPendingTransition(activity: Activity): Unit

Apply any pop animations in the Intent of the given Activity to a pending transition. This should be used in place of Activity.overridePendingTransition to get the appropriate pop animations.

Parameters
activity: Activity

An activity started from the ActivityNavigator.

Public constructors

ActivityNavigator

ActivityNavigator(context: Context)

Public functions

createDestination

open fun createDestination(): ActivityNavigator.Destination
open fun navigate(
    destination: ActivityNavigator.Destination,
    args: Bundle?,
    navOptions: NavOptions?,
    navigatorExtras: Navigator.Extras?
): NavDestination?

Navigate to a destination.

Requests navigation to a given destination associated with this navigator in the navigation graph. This method generally should not be called directly; NavController will delegate to it when appropriate.

Parameters
destination: ActivityNavigator.Destination

destination node to navigate to

args: Bundle?

arguments to use for navigation

navOptions: NavOptions?

additional options for navigation

navigatorExtras: Navigator.Extras?

extras unique to your Navigator.

Returns
NavDestination?

The NavDestination that should be added to the back stack or null if no change was made to the back stack (i.e., in cases of single top operations where the destination is already on top of the back stack).

Throws
kotlin.IllegalArgumentException

if the given destination has no Intent

popBackStack

open fun popBackStack(): Boolean