NavOptionsBuilder

Artifact: androidx.navigation:navigation-common

Added in 2.4.0

Kotlin |Java

android
```
@NavOptionsDsl
class NavOptionsBuilder
```

DSL for constructing a new NavOptions

Summary

Public constructors
`NavOptionsBuilder()`	android

Public functions
`Unit`	`anim(animBuilder: AnimBuilder.() -> Unit)` Sets any custom Animation or Animator resources that should be used.	android
`inline Unit`	`<T : Any> popUpTo(noinline popUpToBuilder: PopUpToBuilder.() -> Unit)` Pop up to a given destination before navigating.	android
`Unit`	`popUpTo(id: @IdRes Int, popUpToBuilder: PopUpToBuilder.() -> Unit)` Pop up to a given destination before navigating.	android
`Unit`	`<T : Any> popUpTo(route: KClass<T>, popUpToBuilder: PopUpToBuilder.() -> Unit)` Pop up to a given destination before navigating.	android
`Unit`	`<T : Any> popUpTo(route: T, popUpToBuilder: PopUpToBuilder.() -> Unit)` Pop up to a given destination before navigating.	android
`Unit`	`popUpTo(route: String, popUpToBuilder: PopUpToBuilder.() -> Unit)` Pop up to a given destination before navigating.	android

Public properties
`Boolean`	`launchSingleTop` Whether this navigation action should launch as single-top (i.e., there will be at most one copy of a given destination on the top of the back stack).	android
`Int`	`popUpTo` This property is deprecated. Use the popUpToId property.	android
`@IdRes Int`	`popUpToId` Returns the current destination that the builder will pop up to.	android
`String?`	`popUpToRoute` The destination to pop up to before navigating.	android
`KClass<*>?`	`popUpToRouteClass` The destination to pop up to before navigating.	android
`Any?`	`popUpToRouteObject` The destination to pop up to before navigating.	android
`Boolean`	`restoreState` Whether this navigation action should restore any state previously saved by `PopUpToBuilder.saveState` or the `popUpToSaveState` attribute.	android

Public constructors

NavOptionsBuilder

android

Added in 2.4.0

NavOptionsBuilder()

Public functions

anim

android

Added in 2.4.0

fun anim(animBuilder: AnimBuilder.() -> Unit): Unit

Sets any custom Animation or Animator resources that should be used.

Note: Animator resources are not supported for navigating to a new Activity

popUpTo

android

inline fun <T : Any> popUpTo(noinline popUpToBuilder: PopUpToBuilder.() -> Unit = {}): Unit

Pop up to a given destination before navigating. This pops all non-matching destination routes from the back stack until the destination with a matching route is found.

Parameters
`<T : Any>`	route from a `KClass` for the destination
`noinline popUpToBuilder: PopUpToBuilder.() -> Unit = {}`	builder used to construct a popUpTo operation

popUpTo

android

Added in 2.4.0

fun popUpTo(id: @IdRes Int, popUpToBuilder: PopUpToBuilder.() -> Unit = {}): Unit

Pop up to a given destination before navigating. This pops all non-matching destinations from the back stack until this destination is found.

popUpTo

android

Added in 2.9.0-alpha05

fun <T : Any> popUpTo(route: KClass<T>, popUpToBuilder: PopUpToBuilder.() -> Unit): Unit

Pop up to a given destination before navigating. This pops all non-matching destination routes from the back stack until the destination with a matching route is found.

Parameters
`route: KClass<T>`	the `KClass` of the destination `T`
`popUpToBuilder: PopUpToBuilder.() -> Unit`	builder used to construct a popUpTo operation

popUpTo

android

Added in 2.8.0

fun <T : Any> popUpTo(route: T, popUpToBuilder: PopUpToBuilder.() -> Unit = {}): Unit

Pop up to a given destination before navigating. This pops all non-matching destination routes from the back stack until the destination with a matching route is found.

Parameters
`route: T`	route from a Object for the destination
`popUpToBuilder: PopUpToBuilder.() -> Unit = {}`	builder used to construct a popUpTo operation

popUpTo

android

Added in 2.4.0

fun popUpTo(route: String, popUpToBuilder: PopUpToBuilder.() -> Unit = {}): Unit

Pop up to a given destination before navigating. This pops all non-matching destination routes from the back stack until the destination with a matching route is found.

Parameters
`route: String`	route for the destination
`popUpToBuilder: PopUpToBuilder.() -> Unit = {}`	builder used to construct a popUpTo operation

Public properties

launchSingleTop

android

Added in 2.4.0

var launchSingleTop: Boolean

Whether this navigation action should launch as single-top (i.e., there will be at most one copy of a given destination on the top of the back stack).

This functions similarly to how android.content.Intent.FLAG_ACTIVITY_SINGLE_TOP works with activities.

popUpTo

android

Added in 2.4.0

Deprecated in 2.4.0

var popUpTo: Int

The destination to pop up to before navigating. All non-matching destinations from the back stack up until this destination will also be popped.

popUpToId

android

Added in 2.4.0

val popUpToId: @IdRes Int

Returns the current destination that the builder will pop up to.

popUpToRoute

android

Added in 2.4.0

val popUpToRoute: String?

The destination to pop up to before navigating. All non-matching destinations from the back stack up until this destination will also be popped.

popUpToRouteClass

android

Added in 2.8.0

val popUpToRouteClass: KClass<*>?

The destination to pop up to before navigating. All non-matching destinations from the back stack up until this destination will also be popped.

popUpToRouteObject

android

Added in 2.8.0

val popUpToRouteObject: Any?

The destination to pop up to before navigating. All non-matching destinations from the back stack up until this destination will also be popped.

restoreState

android

Added in 2.4.0

var restoreState: Boolean

Whether this navigation action should restore any state previously saved by PopUpToBuilder.saveState or the popUpToSaveState attribute. If no state was previously saved with the destination ID being navigated to, this has no effect.