使用选项进行导航

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

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

适用于 Compose 的选项

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

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

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

适用于 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：

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 实例。