Công thức điều hướng có điều kiện
Công thức này minh hoạ cách triển khai chế độ điều hướng có điều kiện, trong đó người dùng chỉ có thể truy cập vào một số đích đến nhất định nếu đáp ứng một điều kiện (trong trường hợp này là nếu người dùng đã đăng nhập).
Cách hoạt động
Ví dụ này có một đích đến Profile yêu cầu người dùng phải đăng nhập. Nếu chưa đăng nhập và cố gắng chuyển đến Profile, người dùng sẽ được chuyển hướng đến màn hình Login. Sau khi đăng nhập thành công, họ sẽ tự động được chuyển đến màn hình Profile.
AppBackStack
Cốt lõi của công thức này là lớp AppBackStack tuỳ chỉnh, giúp đóng gói logic cho hoạt động điều hướng có điều kiện.
-
Giao diện
RequiresLogin: Giao diện đánh dấuRequiresLoginđược dùng để xác định những đích đến yêu cầu người dùng phải đăng nhập. Đích đếnProfiletriển khai giao diện này. -
Chuyển hướng đến trang đăng nhập: Khi hàm
addđược gọi bằng một đích đến triển khaiRequiresLoginvà người dùng chưa đăng nhập,AppBackStacksẽ lưu trữ đích đến dự kiến và thêm tuyến đườngLoginvào ngăn xếp lui. -
Xử lý hoạt động đăng nhập: Khi hàm
loginđược gọi, hàm này sẽ đặt trạng thái của người dùng thành đã đăng nhập. Nếu có một đích đến đã lưu trữ mà người dùng đang cố gắng truy cập, thì đích đến đó sẽ được thêm vào ngăn xếp lui và màn hìnhLoginsẽ bị xoá. -
Xử lý thao tác đăng xuất: Khi hàm
logoutđược gọi, hàm này sẽ đặt trạng thái của người dùng thành đã đăng xuất và xoá mọi đích đến khỏi ngăn xếp lui yêu cầu người dùng phải đăng nhập.
Phương pháp này cung cấp một cách thức rõ ràng để xử lý hoạt động điều hướng có điều kiện bằng cách tập trung logic trong một quy trình triển khai ngăn xếp lui tuỳ chỉnh.
/* * Copyright 2025 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.example.nav3recipes.conditional import android.os.Bundle import androidx.activity.ComponentActivity import androidx.activity.compose.setContent import androidx.compose.foundation.layout.Column import androidx.compose.material3.Button import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.runtime.getValue import androidx.compose.runtime.setValue import androidx.compose.runtime.mutableStateOf import androidx.compose.runtime.remember import androidx.compose.runtime.saveable.rememberSaveable import androidx.compose.runtime.saveable.rememberSerializable import androidx.navigation3.runtime.NavBackStack import androidx.navigation3.runtime.NavKey import androidx.navigation3.runtime.entryProvider import androidx.navigation3.runtime.serialization.NavBackStackSerializer import androidx.navigation3.runtime.serialization.NavKeySerializer import androidx.navigation3.ui.NavDisplay import com.example.nav3recipes.content.ContentBlue import com.example.nav3recipes.content.ContentGreen import com.example.nav3recipes.content.ContentYellow import kotlinx.serialization.Serializable /** * Class for representing navigation keys in the app. * * Note: We use a sealed class because KotlinX Serialization handles * polymorphic serialization of sealed classes automatically. * * @param requiresLogin - true if the navigation key requires that the user is logged in * to navigate to it */ @Serializable sealed class ConditionalNavKey(val requiresLogin: Boolean = false) : NavKey /** * Key representing home screen */ @Serializable private data object Home : ConditionalNavKey() /** * Key representing profile screen that is only accessible once the user has logged in */ @Serializable private data object Profile : ConditionalNavKey(requiresLogin = true) /** * Key representing login screen * * @param redirectToKey - navigation key to redirect to after successful login */ @Serializable private data class Login( val redirectToKey: ConditionalNavKey? = null ) : ConditionalNavKey() class ConditionalActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContent { val backStack = rememberNavBackStack<ConditionalNavKey>(Home) var isLoggedIn by rememberSaveable { mutableStateOf(false) } val navigator = remember { Navigator( backStack = backStack, onNavigateToRestrictedKey = { redirectToKey -> Login(redirectToKey) }, isLoggedIn = { isLoggedIn } ) } NavDisplay( backStack = backStack, onBack = { navigator.goBack() }, entryProvider = entryProvider { entry<Home> { ContentGreen("Welcome to Nav3. Logged in? ${isLoggedIn}") { Column { Button(onClick = { navigator.navigate(Profile) }) { Text("Profile") } Button(onClick = { navigator.navigate(Login()) }) { Text("Login") } } } } entry<Profile> { ContentBlue("Profile screen (only accessible once logged in)") { Button(onClick = { isLoggedIn = false navigator.navigate(Home) }) { Text("Logout") } } } entry<Login> { key -> ContentYellow("Login screen. Logged in? $isLoggedIn") { Button(onClick = { isLoggedIn = true key.redirectToKey?.let { targetKey -> backStack.remove(key) navigator.navigate(targetKey) } }) { Text("Login") } } } } ) } } } // An overload of `rememberNavBackStack` that returns a subtype of `NavKey`. // See https://issuetracker.google.com/issues/463382671 for a discussion of this function @Composable fun <T : NavKey> rememberNavBackStack(vararg elements: T): NavBackStack<T> { return rememberSerializable( serializer = NavBackStackSerializer(elementSerializer = NavKeySerializer()) ) { NavBackStack(*elements) } }