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()
см. в руководстве «Навигация с параметрами» .
Поп с помощью действий
При навигации с помощью действия вы можете дополнительно извлечь дополнительные пункты назначения из задней стопки. Например, если в вашем приложении есть первоначальный поток входа в систему, после того как пользователь вошел в систему, вам следует удалить все места назначения, связанные с входом в систему, из обратного стека, чтобы кнопка «Назад» не возвращала пользователей обратно в поток входа в систему.
Дополнительное чтение
Для получения дополнительной информации прочитайте следующие страницы:
- Круговая навигация . Узнайте, как избежать перегруженного обратного стека в случаях, когда потоки навигации являются круговыми.
- Пункты назначения диалогов : узнайте, как пункты назначения диалогов привносят уникальные особенности в управление вашим стеком.