Навигация и задний стек

NavController содержит «обратный стек», содержащий пункты назначения, которые посетил пользователь. Когда пользователь перемещается по экранам вашего приложения, NavController добавляет и удаляет пункты назначения в заднем стеке и из него.

Будучи стеком, задний стек представляет собой структуру данных «последним пришел — первым ушел». Таким образом, NavController помещает элементы в верхнюю часть стека и извлекает их из нее.

Основное поведение

Вот основные факты, которые следует учитывать в отношении поведения обратного стека:

  • Первый пункт назначения: когда пользователь открывает приложение, NavController помещает первый пункт назначения в начало заднего стека.
  • Занесение в стек: каждый вызов NavController.navigate() помещает заданный пункт назначения в вершину стека.
  • Выдвижение верхнего пункта назначения: нажатие « Вверх» или «Назад» вызывает методы NavController.navigateUp() и NavController.popBackStack() соответственно. Они извлекают верхний пункт назначения из стека. См. страницу «Принципы навигации» для получения дополнительной информации о разнице между «Вверх» и «Назад» .

Вернитесь назад

Метод NavController.popBackStack() пытается извлечь текущий пункт назначения из заднего стека и перейти к предыдущему пункту назначения. Это эффективно перемещает пользователя на один шаг назад в истории навигации. Он возвращает логическое значение, указывающее, успешно ли он вернулся в пункт назначения.

Вернитесь к определенному пункту назначения

Вы также можете использовать popBackStack() для перехода к определенному пункту назначения. Для этого используйте одну из его перегрузок. Некоторые из них позволяют передавать идентификатор, например целочисленный id или строковый route . Эти перегрузки доставляют пользователя к месту назначения, связанному с данным идентификатором. Что особенно важно, они извлекают все, что находится в стеке выше этого пункта назначения.

Эти перегрузки также принимают inclusive логическое значение. Он определяет, должен ли NavController также извлечь указанный пункт назначения из заднего стека после перехода к нему.

Рассмотрим этот краткий фрагмент в качестве примера:

navController.popBackStack(R.id.destinationId, true)

Здесь NavController возвращается к месту назначения с целочисленным идентификатором destinationId . Поскольку значение inclusive аргумента равно true , NavController также извлекает указанный пункт назначения из заднего стека.

Обработка неудачного всплывающего окна

Когда popBackStack() возвращает false , последующий вызов NavController.getCurrentDestination() возвращает null . Это означает, что приложение извлекло последний пункт назначения из стека. В этом случае пользователь видит только пустой экран.

Это может произойти в следующих случаях:

  • popBackStack() ничего не извлекал из стека.
  • popBackStack() извлек пункт назначения из заднего стека, и теперь стек пуст.

Чтобы решить эту проблему, вам необходимо перейти к новому месту назначения или вызвать finish() в своей деятельности, чтобы завершить ее. Следующий фрагмент демонстрирует это:

котлин

...

if (!navController.popBackStack()) {
    // Call finish() on your Activity
    finish()
}

Ява

...

if (!navController.popBackStack()) {
    // Call finish() on your Activity
    finish();
}

Всплывающее сообщение о пункте назначения

Чтобы удалить пункты назначения из заднего стека при переходе от одного пункта назначения к другому, добавьте аргумент popUpTo() к соответствующему вызову функции navigate() . popUpTo() инструктирует библиотеку навигации удалить некоторые пункты назначения из заднего стека как часть вызова navigate() . Значение параметра — это идентификатор пункта назначения в заднем стеке. Идентификатор может быть целочисленным id или строкой route .

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

Чтобы реализовать это программно, передайте popUpTo() в navigate() как часть NavOptions с inclusive значением true . Это работает как в Compose, так и в Views.

Сохранять состояние при появлении

Когда вы используете popUpTo для перехода к пункту назначения, вы можете дополнительно сохранить задний стек и состояния всех пунктов назначения, извлеченные из заднего стека. Затем вы сможете восстановить задний стек и пункты назначения при переходе к этому пункту назначения позднее. Это позволяет сохранять состояние для данного места назначения и иметь несколько обратных стеков .

Чтобы сделать это программно, укажите saveState = true при добавлении popUpTo к параметрам навигации.

Вы также можете указать restoreState = true в параметрах навигации, чтобы автоматически восстановить задний стек и состояние, связанное с пунктом назначения.

Например:

navController.navigate(
    route = route,
    navOptions =  navOptions {
        popUpTo<A>{ saveState = true }
        restoreState = true
    }
)

Чтобы включить сохранение и восстановление состояния в XML, определите popUpToSaveState как true и restoreState как true соответственно в соответствующем action .

XML-пример

Вот пример popUpTo в XML с использованием действия:

<action
  android:id="@+id/action_a_to_b"
  app:destination="@id/b"
  app:popUpTo="@+id/a"
  app:popUpToInclusive="true"
  app:restoreState=”true”
  app:popUpToSaveState="true"/>

Пример создания

Ниже приведен полный пример того же самого в Compose:

@Composable
fun MyAppNavHost(
    modifier: Modifier = Modifier,
    navController: NavHostController = rememberNavController(),
    startDestination: Any = A
) {
    NavHost(
        modifier = modifier,
        navController = navController,
        startDestination = startDestination
    ) {
        composable<A> {
            DestinationA(
                onNavigateToB = {
                // Pop everything up to, and including, the A destination off
                // the back stack, saving the back stack and the state of its
                // destinations.
                // Then restore any previous back stack state associated with
                // the B destination.
                // Finally navigate to the B destination.
                    navController.navigate(route = B) {
                        popUpTo<A> {
                            inclusive = true
                            saveState = true
                        }
                        restoreState = true
                    }
                },
            )
        }
        composable<B> { DestinationB(/* ... */) }
    }
}

@Composable
fun DestinationA(onNavigateToB: () -> Unit) {
    Button(onClick = onNavigateToB) {
        Text("Go to A")
    }
}

Более детально вы можете изменить способ вызова NavController.navigate() следующими способами:

// Pop everything up to the destination_a destination off the back stack before
// navigating to the "destination_b" destination
navController.navigate("destination_b") {
    popUpTo("destination_a")
}

// Pop everything up to and including the "destination_a" destination off
// the back stack before navigating to the "destination_b" destination
navController.navigate("destination_b") {
    popUpTo("destination_a") { inclusive = true }
}

// Navigate to the "search” destination only if we’re not already on
// the "search" destination, avoiding multiple copies on the top of the
// back stack
navController.navigate("search") {
    launchSingleTop = true
}

Общие сведения о передаче параметров в NavController.navigate() см. в руководстве «Навигация с параметрами» .

Поп с помощью действий

При навигации с помощью действия вы можете дополнительно извлечь дополнительные пункты назначения из задней стопки. Например, если в вашем приложении есть первоначальный поток входа в систему, после того как пользователь вошел в систему, вам следует удалить все места назначения, связанные с входом в систему, из обратного стека, чтобы кнопка «Назад» не возвращала пользователей обратно в поток входа в систему.

Дополнительное чтение

Для получения дополнительной информации прочитайте следующие страницы:

  • Круговая навигация . Узнайте, как избежать перегруженного обратного стека в случаях, когда потоки навигации являются круговыми.
  • Пункты назначения диалогов : узнайте, как пункты назначения диалогов привносят уникальные особенности в управление вашим стеком.
,

NavController содержит «обратный стек», содержащий пункты назначения, которые посетил пользователь. Когда пользователь перемещается по экранам вашего приложения, NavController добавляет и удаляет пункты назначения в заднем стеке и из него.

Будучи стеком, задний стек представляет собой структуру данных «последним пришел — первым ушел». Таким образом, NavController помещает элементы в верхнюю часть стека и извлекает их из нее.

Основное поведение

Вот основные факты, которые следует учитывать в отношении поведения обратного стека:

  • Первый пункт назначения: когда пользователь открывает приложение, NavController помещает первый пункт назначения в начало заднего стека.
  • Занесение в стек: каждый вызов NavController.navigate() помещает заданный пункт назначения в вершину стека.
  • Выдвижение верхнего пункта назначения: нажатие « Вверх» или «Назад» вызывает методы NavController.navigateUp() и NavController.popBackStack() соответственно. Они извлекают верхний пункт назначения из стека. См. страницу «Принципы навигации» для получения дополнительной информации о разнице между «Вверх» и «Назад» .

Вернитесь назад

Метод NavController.popBackStack() пытается извлечь текущий пункт назначения из заднего стека и перейти к предыдущему пункту назначения. Это эффективно перемещает пользователя на один шаг назад в истории навигации. Он возвращает логическое значение, указывающее, успешно ли он вернулся в пункт назначения.

Вернитесь к определенному пункту назначения

Вы также можете использовать popBackStack() для перехода к определенному пункту назначения. Для этого используйте одну из его перегрузок. Некоторые из них позволяют передавать идентификатор, например целочисленный id или строковый route . Эти перегрузки перенаправляют пользователя к месту назначения, связанному с данным идентификатором. Что особенно важно, они извлекают все, что находится в стеке выше этого пункта назначения.

Эти перегрузки также принимают inclusive логическое значение. Он определяет, должен ли NavController также извлечь указанный пункт назначения из заднего стека после перехода к нему.

Рассмотрим этот краткий фрагмент в качестве примера:

navController.popBackStack(R.id.destinationId, true)

Здесь NavController возвращается в пункт назначения с целочисленным идентификатором destinationId . Поскольку значение inclusive аргумента равно true , NavController также извлекает указанный пункт назначения из заднего стека.

Обработка неудачного всплывающего окна

Когда popBackStack() возвращает false , последующий вызов NavController.getCurrentDestination() возвращает null . Это означает, что приложение извлекло последний пункт назначения из стека. В этом случае пользователь видит только пустой экран.

Это может произойти в следующих случаях:

  • popBackStack() ничего не извлекал из стека.
  • popBackStack() извлек пункт назначения из заднего стека, и теперь стек пуст.

Чтобы решить эту проблему, вам необходимо перейти к новому месту назначения или вызвать finish() в своей деятельности, чтобы завершить ее. Следующий фрагмент демонстрирует это:

котлин

...

if (!navController.popBackStack()) {
    // Call finish() on your Activity
    finish()
}

Ява

...

if (!navController.popBackStack()) {
    // Call finish() on your Activity
    finish();
}

Всплывающее сообщение о пункте назначения

Чтобы удалить пункты назначения из заднего стека при переходе от одного пункта назначения к другому, добавьте аргумент popUpTo() к соответствующему вызову функции navigate() . popUpTo() инструктирует библиотеку навигации удалить некоторые пункты назначения из заднего стека как часть вызова navigate() . Значение параметра — это идентификатор пункта назначения в заднем стеке. Идентификатор может быть целочисленным id или строкой route .

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

Чтобы реализовать это программно, передайте popUpTo() в navigate() как часть NavOptions с inclusive значением true . Это работает как в Compose, так и в Views.

Сохранять состояние при появлении

Когда вы используете popUpTo для перехода к пункту назначения, вы можете дополнительно сохранить задний стек и состояния всех пунктов назначения, извлеченные из заднего стека. Затем вы сможете восстановить задний стек и пункты назначения при переходе к этому пункту назначения позднее. Это позволяет сохранять состояние для данного места назначения и иметь несколько обратных стеков .

Чтобы сделать это программно, укажите saveState = true при добавлении popUpTo к параметрам навигации.

Вы также можете указать restoreState = true в параметрах навигации, чтобы автоматически восстановить задний стек и состояние, связанное с местом назначения.

Например:

navController.navigate(
    route = route,
    navOptions =  navOptions {
        popUpTo<A>{ saveState = true }
        restoreState = true
    }
)

Чтобы включить сохранение и восстановление состояния в XML, определите popUpToSaveState как true и restoreState как true соответственно в соответствующем action .

XML-пример

Вот пример popUpTo в XML с использованием действия:

<action
  android:id="@+id/action_a_to_b"
  app:destination="@id/b"
  app:popUpTo="@+id/a"
  app:popUpToInclusive="true"
  app:restoreState=”true”
  app:popUpToSaveState="true"/>

Пример создания

Ниже приведен полный пример того же самого в Compose:

@Composable
fun MyAppNavHost(
    modifier: Modifier = Modifier,
    navController: NavHostController = rememberNavController(),
    startDestination: Any = A
) {
    NavHost(
        modifier = modifier,
        navController = navController,
        startDestination = startDestination
    ) {
        composable<A> {
            DestinationA(
                onNavigateToB = {
                // Pop everything up to, and including, the A destination off
                // the back stack, saving the back stack and the state of its
                // destinations.
                // Then restore any previous back stack state associated with
                // the B destination.
                // Finally navigate to the B destination.
                    navController.navigate(route = B) {
                        popUpTo<A> {
                            inclusive = true
                            saveState = true
                        }
                        restoreState = true
                    }
                },
            )
        }
        composable<B> { DestinationB(/* ... */) }
    }
}

@Composable
fun DestinationA(onNavigateToB: () -> Unit) {
    Button(onClick = onNavigateToB) {
        Text("Go to A")
    }
}

Более детально вы можете изменить способ вызова NavController.navigate() следующими способами:

// Pop everything up to the destination_a destination off the back stack before
// navigating to the "destination_b" destination
navController.navigate("destination_b") {
    popUpTo("destination_a")
}

// Pop everything up to and including the "destination_a" destination off
// the back stack before navigating to the "destination_b" destination
navController.navigate("destination_b") {
    popUpTo("destination_a") { inclusive = true }
}

// Navigate to the "search” destination only if we’re not already on
// the "search" destination, avoiding multiple copies on the top of the
// back stack
navController.navigate("search") {
    launchSingleTop = true
}

Общие сведения о передаче параметров в NavController.navigate() см. в руководстве «Навигация с параметрами» .

Поп с помощью действий

При навигации с помощью действия вы можете дополнительно извлечь дополнительные пункты назначения из задней стопки. Например, если в вашем приложении есть первоначальный поток входа в систему, после того как пользователь вошел в систему, вам следует удалить все места назначения, связанные с входом в систему, из стека, чтобы кнопка «Назад» не возвращала пользователей обратно в поток входа в систему.

Дополнительное чтение

Для получения дополнительной информации прочитайте следующие страницы:

  • Круговая навигация . Узнайте, как избежать перегруженного обратного стека в случаях, когда потоки навигации являются круговыми.
  • Пункты назначения диалогов : узнайте, как пункты назначения диалогов привносят уникальные особенности в управление вашим стеком.