Навигация с параметрами

Когда вы определяете действие на графе навигации с помощью Kotlin DSL, Navigation генерирует соответствующий класс NavAction, который содержит конфигурации, определенные для этого действия, в том числе:

• Destination: идентификатор ресурса целевого объекта.
• Аргументы по умолчанию. Объект android.os.Bundle, содержащий значения по умолчанию для целевого объекта, если они указаны.
• Варианты навигации NavOptions. Этот класс содержит все специальные конфигурации для перехода к целевому пункту назначения и обратно, включая конфигурацию ресурсов анимации, поведение всплывающих окон и то, должен ли пункт назначения запускаться в режиме singleTop.

Возможности Compose

По умолчанию navigate() добавляет новый пункт назначения в обратный стек. Вы можете изменить поведение navigate(), передав дополнительные параметры навигации в вызов navigate().

Вы можете создать экземпляр 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(), передав идентификатор действия, как показано в следующем примере:

    navController.navigate(R.id.action_b_to_a)

Как применить параметры программно

В предыдущих примерах показано, как указать NavOptions в XML-коде графа навигации. Однако конкретные варианты могут варьироваться в зависимости от ограничений, которые неизвестны во время сборки. В таких случаях объект NavOptions необходимо создать и настроить программно, как показано в примере ниже.

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
    }
  }
)

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 при переходе по неявным ссылкам на контент:

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

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.