Tìm hiểu và triển khai các kiến thức cơ bản

Navigation mô tả cách người dùng thao tác trong ứng dụng của bạn. Người dùng tương tác với các phần tử trên giao diện người dùng, thường là bằng cách nhấn hoặc nhấp vào các phần tử đó và ứng dụng sẽ phản hồi bằng cách hiển thị nội dung mới. Nếu muốn quay lại nội dung trước, người dùng sẽ sử dụng cử chỉ quay lại hoặc nhấn vào nút quay lại.

Trạng thái điều hướng lập mô hình

Một cách thuận tiện để lập mô hình hành vi này là sử dụng một ngăn xếp nội dung. Khi người dùng di chuyển về phía trước đến nội dung mới, nội dung đó sẽ được đẩy lên đầu ngăn xếp. Khi họ quay lại từ nội dung đó, nội dung đó sẽ được kéo ra khỏi ngăn xếp và nội dung trước đó sẽ xuất hiện. Trong thuật ngữ điều hướng, ngăn xếp này thường được gọi là ngăn xếp lui vì nó đại diện cho nội dung mà người dùng có thể quay lại.

Nút hành động trên bàn phím phần mềm (biểu tượng dấu kiểm) được khoanh tròn màu đỏ.
Hình 1. Sơ đồ cho thấy cách ngăn xếp lui thay đổi theo các sự kiện điều hướng của người dùng.

Tạo ngăn xếp lui

Trong Navigation 3, ngăn xếp lui không thực sự chứa nội dung. Thay vào đó, tệp này chứa tham chiếu đến nội dung, được gọi là khoá. Khoá có thể thuộc bất kỳ loại nào nhưng thường là các lớp dữ liệu đơn giản, có thể chuyển đổi tuần tự. Việc sử dụng tệp đối chiếu thay vì nội dung mang lại những lợi ích sau:

  • Bạn có thể dễ dàng điều hướng bằng cách đẩy các khoá vào ngăn xếp lui.
  • Miễn là các khoá có thể chuyển đổi tuần tự, ngăn xếp lui có thể được lưu vào bộ nhớ ổn định, cho phép ngăn xếp lui duy trì sau khi thay đổi cấu hình và buộc tắt. Điều này rất quan trọng vì người dùng muốn rời khỏi ứng dụng của bạn, quay lại sau và tiếp tục từ nơi họ đã dừng lại với cùng một nội dung được hiển thị. Hãy xem phần Lưu ngăn xếp lui để biết thêm thông tin.

Một khái niệm chính trong Navigation 3 API là bạn sở hữu ngăn xếp lui. Thư viện:

  • Dự kiến ngăn xếp lui của bạn sẽ là một List<T> được hỗ trợ trạng thái tổng quan nhanh, trong đó T là loại keys của ngăn xếp lui. Bạn có thể sử dụng Any hoặc cung cấp các khoá riêng, có kiểu dữ liệu mạnh hơn. Khi bạn thấy các thuật ngữ "push" (đẩy) hoặc "pop" (bật), thì việc triển khai cơ bản là thêm hoặc xoá các mục ở cuối danh sách.
  • Quan sát ngăn xếp lui và phản ánh trạng thái của ngăn xếp đó trong giao diện người dùng bằng cách sử dụng NavDisplay.

Ví dụ sau đây cho thấy cách tạo khoá và ngăn xếp lui, cũng như sửa đổi ngăn xếp lui để phản hồi các sự kiện điều hướng của người dùng:

// Define keys that will identify content
data object ProductList
data class ProductDetail(val id: String)

@Composable
fun MyApp() {

    // Create a back stack, specifying the key the app should start with
    val backStack = remember { mutableStateListOf<Any>(ProductList) }

    // Supply your back stack to a NavDisplay so it can reflect changes in the UI
    // ...more on this below...

    // Push a key onto the back stack (navigate forward), the navigation library will reflect the change in state
    backStack.add(ProductDetail(id = "ABC"))

    // Pop a key off the back stack (navigate back), the navigation library will reflect the change in state
    backStack.removeLastOrNull()
}

Giải quyết khoá cho nội dung

Nội dung được mô hình hoá trong Navigation 3 bằng NavEntry, một lớp chứa hàm composable. Nó đại diện cho một đích đến – một phần nội dung mà người dùng có thể di chuyển đến và quay lại.

NavEntry cũng có thể chứa siêu dữ liệu – thông tin về nội dung. Các đối tượng vùng chứa (chẳng hạn như NavDisplay) có thể đọc siêu dữ liệu này để quyết định cách hiển thị nội dung của NavEntry. Ví dụ: bạn có thể dùng siêu dữ liệu để ghi đè ảnh động mặc định cho một NavEntry cụ thể. NavEntry metadata là một bản đồ gồm các khoá String đến giá trị Any, cung cấp bộ nhớ dữ liệu linh hoạt.

Để chuyển đổi key thành NavEntry, hãy tạo một Nhà cung cấp mục nhập. Đây là một hàm chấp nhận key và trả về NavEntry cho key đó. Tham số này thường được xác định là tham số lambda khi tạo NavDisplay.

Có hai cách để tạo Nhà cung cấp mục nhập, bằng cách tạo trực tiếp hàm lambda hoặc bằng cách sử dụng DSL entryProvider.

Tạo trực tiếp hàm Entry Provider

Thông thường, bạn sẽ tạo một hàm Entry Provider bằng câu lệnh when, với một nhánh cho mỗi khoá.

entryProvider = { key ->
    when (key) {
        is ProductList -> NavEntry(key) { Text("Product List") }
        is ProductDetail -> NavEntry(
            key,
            metadata = mapOf("extraDataKey" to "extraDataValue")
        ) { Text("Product ${key.id} ") }

        else -> {
            NavEntry(Unit) { Text(text = "Invalid Key: $it") }
        }
    }
}

Sử dụng DSL entryProvider

entryProvider DSL có thể đơn giản hoá hàm lambda của bạn bằng cách tránh việc phải kiểm thử từng loại khoá và tạo NavEntry cho từng loại khoá. Hãy sử dụng hàm tạo entryProvider cho việc này. Hàm này cũng bao gồm hành vi dự phòng mặc định (gửi lỗi) nếu không tìm thấy khoá.

entryProvider = entryProvider {
    entry<ProductList> { Text("Product List") }
    entry<ProductDetail>(
        metadata = mapOf("extraDataKey" to "extraDataValue")
    ) { key -> Text("Product ${key.id} ") }
}

Hãy lưu ý những điều sau trong đoạn mã:

  • entry dùng để xác định NavEntry có loại và nội dung composable đã cho
  • entry chấp nhận tham số metadata để đặt NavEntry.metadata

Hiển thị ngăn xếp lui

Ngăn xếp lui thể hiện trạng thái điều hướng của ứng dụng. Bất cứ khi nào ngăn xếp lui thay đổi, giao diện người dùng của ứng dụng sẽ phản ánh trạng thái mới của ngăn xếp lui. Trong Navigation 3, NavDisplay sẽ quan sát ngăn xếp lui và cập nhật giao diện người dùng cho phù hợp. Tạo đối tượng này bằng các tham số sau:

  • Ngăn xếp lui – phải thuộc loại SnapshotStateList<T>, trong đó T là loại khoá ngăn xếp lui. Đây là một List có thể quan sát được, nhờ đó, nó sẽ kích hoạt quá trình tái cấu trúc NavDisplay khi có thay đổi.
  • Một entryProvider để chuyển đổi các khoá trong ngăn xếp lui thành đối tượng NavEntry.
  • Bạn có thể cung cấp một hàm lambda cho tham số onBack. Hàm này được gọi khi người dùng kích hoạt sự kiện quay lại.

Ví dụ sau đây cho thấy cách tạo NavDisplay.

data object Home
data class Product(val id: String)

@Composable
fun NavExample() {

    val backStack = remember { mutableStateListOf<Any>(Home) }

    NavDisplay(
        backStack = backStack,
        onBack = { backStack.removeLastOrNull() },
        entryProvider = { key ->
            when (key) {
                is Home -> NavEntry(key) {
                    ContentGreen("Welcome to Nav3") {
                        Button(onClick = {
                            backStack.add(Product("123"))
                        }) {
                            Text("Click to navigate")
                        }
                    }
                }

                is Product -> NavEntry(key) {
                    ContentBlue("Product ${key.id} ")
                }

                else -> NavEntry(Unit) { Text("Unknown route") }
            }
        }
    )
}

Theo mặc định, NavDisplay cho thấy NavEntry trên cùng trên ngăn xếp lui trong bố cục một ngăn. Bản ghi sau đây cho thấy ứng dụng này đang chạy:

Hành vi mặc định của `NavDisplay` với hai đích đến.
Hình 2. NavDisplay hành vi mặc định với hai đích đến.

Vòng đời của đích đến

NavDisplay sử dụng LifecycleOwner tuỳ chỉnh để giới hạn trạng thái vòng đời của một NavEntry dựa trên cả các quy tắc ràng buộc ở cấp Cảnh và các quy tắc ràng buộc ở cấp Mục nhập.

Để biết thêm thông tin về vòng đời trong Compose, hãy xem bài viết Vòng đời trong Jetpack Compose.

Các quy tắc ràng buộc về vòng đời ở cấp cảnh

NavDisplay quản lý vòng đời của Scene đang hoạt động. Giới hạn ở cấp cảnh được xác định như sau:

Đối với cảnh không có lớp phủ:

  • RESUMED: Chỉ được phép khi quá trình chuyển đổi cảnh đã ổn định và không có cảnh lớp phủ nào đang hoạt động hiển thị phía trên cảnh đó.
  • STARTED: Giới hạn ở STARTED trong khi chuyển đổi cảnh, chẳng hạn như khi di chuyển tiến hoặc lùi, hoặc khi bị lớp phủ che khuất.

Đối với cảnh lớp phủ, chẳng hạn như hộp thoại hoặc bảng dưới cùng:

  • RESUMED: Chỉ được phép cho cảnh lớp phủ trên cùng, hiện đang hoạt động.
  • STARTED: Giới hạn ở STARTED cho mọi cảnh lớp phủ cơ bản được bao phủ bởi một lớp phủ mới hơn.

Trạng thái vòng đời ở cấp đầu vào

Thư viện quản lý trạng thái vòng đời tối đa của từng NavEntry dựa trên sự hiện diện của nó trong ngăn xếp lui:

  • RESUMED: Nếu mục nhập có trong ngăn xếp lui hiện tại, thì vòng đời của mục nhập đó được phép tăng lên RESUMED (tuỳ thuộc vào giới hạn ở cấp cảnh).
  • CREATED: Nếu mục nhập không còn trong ngăn xếp lui, chẳng hạn như khi mục nhập đó được bật lên nhưng vẫn đang hiển thị trên màn hình trong khi tạo ảnh động, thì thư viện sẽ giới hạn nghiêm ngặt vòng đời của mục nhập đó ở CREATED. Giới hạn này đảm bảo rằng các mục nhập trong nền hoặc mục nhập thoát sẽ ngừng thực thi công việc đang hoạt động, chẳng hạn như thu thập luồng hoặc khởi chạy coroutine liên kết với trạng thái RESUMED hoặc STARTED trong khi hoàn tất quá trình chuyển đổi thoát.

Cách kết hợp các tính năng này

Ví dụ: trạng thái vòng đời cuối cùng của NavEntry được phân giải như sau:

Trường hợp Giới hạn ở cấp cảnh Mũ tốt nghiệp Giới hạn hiệu quả
Mục đang hoạt động, màn hình ổn định (không có hiệu ứng chuyển đổi hoặc lớp phủ) RESUMED RESUMED RESUMED
Mục đang hoạt động, trong quá trình chuyển đổi (di chuyển đến hoặc đi) STARTED RESUMED STARTED
Mục nhập đang hoạt động, được che phủ bằng lớp phủ (ví dụ: Hộp thoại đang mở) STARTED RESUMED STARTED
Mục nhập bật lên, tạo ảnh động STARTED hoặc RESUMED CREATED CREATED

Kết hợp kiến thức đã học

Sơ đồ sau đây cho thấy cách dữ liệu di chuyển giữa các đối tượng trong Navigation 3:

Hình ảnh minh hoạ cách dữ liệu luân chuyển giữa các đối tượng trong Navigation 3.
Hình 3. Sơ đồ cho thấy cách dữ liệu di chuyển qua nhiều đối tượng trong Navigation 3.
  1. Sự kiện điều hướng bắt đầu thay đổi. Các khoá được thêm hoặc xoá khỏi ngăn xếp lui để phản hồi tương tác của người dùng.

  2. Thay đổi trong trạng thái ngăn xếp lui sẽ kích hoạt quá trình truy xuất nội dung. NavDisplay (một composable hiển thị ngăn xếp lui) sẽ quan sát ngăn xếp lui. Trong cấu hình mặc định, thành phần này sẽ hiển thị mục nhập ngăn xếp lui trên cùng trong bố cục một ngăn. Khi khoá trên cùng trong ngăn xếp lui thay đổi, NavDisplay sẽ sử dụng khoá này để yêu cầu nội dung tương ứng từ nhà cung cấp mục nhập.

  3. Nhà cung cấp mục nhập cung cấp nội dung. Nhà cung cấp mục nhập là một hàm phân giải khoá thành NavEntry. Khi nhận được khoá từ NavDisplay, nhà cung cấp mục nhập sẽ cung cấp NavEntry liên kết, chứa cả khoá và nội dung.

  4. Nội dung được hiển thị. NavDisplay nhận NavEntry và hiển thị nội dung.