使用选项进行导航

当您使用 Kotlin DSL 在导航图中定义操作时，Navigation 会生成相应的 NavAction 类，其中包含为该操作定义的配置，包括如下内容：

• 目的地：目标目的地的资源 ID。
• 默认参数：android.os.Bundle，包含目标目的地的默认值（如有提供）。
• 导航选项：导航选项，表示为 NavOptions。此类包含传输至目标目的地以及从该处传出的所有特殊配置，包括动画资源配置、弹出行为，以及是否应在单一顶级模式下启动目的地。

适用于 Compose 的选项

默认情况下，navigate() 会将您的新目的地添加到返回堆栈中。您可以通过向 navigate() 调用传递其他导航选项来修改 navigate() 的行为。

您可以使用简单的 lambda 创建 NavOptions 实例。向 navigate() 传递本来可能明确传递给 NavOptions.Builder 的参数。请参考以下示例：

如需查看如何在上下文中将选项传递给 navigate() 的示例，请参阅返回堆栈指南。

注意：您不能将 anim 块与 Navigation Compose 搭配使用。有一项功能请求用于跟踪 Navigation Compose 中的转场动画。

注意：用户的当前位置已存在于返回堆栈中。当用户首次导航到目的地（而非用户离开）时，它会显示在返回堆栈中。

适用于 XML 的选项

下面是一个示例导航图，其中包含两个屏幕，以及用于从一个屏幕导航到另一个屏幕的操作：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
            xmlns:app="http://schemas.android.com/apk/res-auto"
            xmlns:tools="http://schemas.android.com/tools"
            android:id="@+id/nav_graph"
            app:startDestination="@id/a">

    <fragment android:id="@+id/a"
              android:name="com.example.myapplication.FragmentA"
              android:label="a"
              tools:layout="@layout/a">
        <action android:id="@+id/action_a_to_b"
                app:destination="@id/b"
                app:enterAnim="@anim/nav_default_enter_anim"
                app:exitAnim="@anim/nav_default_exit_anim"
                app:popEnterAnim="@anim/nav_default_pop_enter_anim"
                app:popExitAnim="@anim/nav_default_pop_exit_anim"/>
    </fragment>

    <fragment android:id="@+id/b"
              android:name="com.example.myapplication.FragmentB"
              android:label="b"
              tools:layout="@layout/b">
        <action android:id="@+id/action_b_to_a"
                app:destination="@id/a"
                app:enterAnim="@anim/nav_default_enter_anim"
                app:exitAnim="@anim/nav_default_exit_anim"
                app:popEnterAnim="@anim/nav_default_pop_enter_anim"
                app:popExitAnim="@anim/nav_default_pop_exit_anim"
                app:popUpTo="@+id/a"
                app:popUpToInclusive="true"/>
    </fragment>
</navigation>

膨胀该导航图时，系统会解析这些操作，同时使用图中定义的配置生成相应的 NavAction 对象。例如，action_b_to_a 定义为从目的地 b 导航到目的地 a。该操作包含动画以及 popTo 行为，该行为会从返回堆栈中移除所有目的地。所有这些设置都会以 NavOptions 形式捕获并关联到 NavAction。

如需执行此 NavAction，请使用 NavController.navigate() 并传递操作的 ID，如下例所示：

    navController.navigate(R.id.action_b_to_a)

以编程方式应用选项

前面的示例展示了如何在导航图 XML 中指定 NavOptions。不过，具体选项可能会因构建时未知的约束条件而异。在这种情况下，必须以编程方式创建和设置 NavOptions，如以下示例所示：

Kotlin

findNavController().navigate(
R.id.action_fragmentOne_to_fragmentTwo,
null,
navOptions { // Use the Kotlin DSL for building NavOptions
    anim {
        enter = android.R.animator.fade_in
        exit = android.R.animator.fade_out
    }
  }
)

Java

NavController navController = NavHostFragment.findNavController(this);
  navController.navigate(
    R.id.action_fragmentOne_to_fragmentTwo,
    null,
    new NavOptions.Builder()
      .setEnterAnim(android.R.animator.fade_in)
      .setExitAnim(android.R.animator.fade_out)
      .build()
  );

此示例使用了 navigate() 的扩展形式，并包含额外的 Bundle 和 NavOptions 参数。navigate() 的所有变体都有接受 NavOptions 参数的扩展版本。

注意：以编程方式应用的 NavOptions 会替换在 XML 中设置的所有选项。

您还可以在导航到隐式深层链接时以编程方式应用 NavOptions：

Kotlin

findNavController().navigate(
    deepLinkUri,
    navOptions { // Use the Kotlin DSL for building NavOptions
        anim {
            enter = android.R.animator.fade_in
            exit = android.R.animator.fade_out
        }
    }
)

Java

NavController navController = NavHostFragment.findNavController(this);
navController.navigate(
        deepLinkUri,
        new NavOptions.Builder()
                .setEnterAnim(android.R.animator.fade_in)
                .setExitAnim(android.R.animator.fade_out)
                .build()
);

这个 navigate() 变体会接受 Uri（作为隐式深层链接）以及 NavOptions 实例。