Để triển khai một hệ thống điều hướng mạnh mẽ, ứng dụng của bạn cần có một cách tập trung để xử lý cử chỉ quay lại và các tín hiệu điều hướng khác. Trang này mô tả cách sử dụng NavigationEventDispatcher để điều phối và phân phối các sự kiện điều hướng này trong ứng dụng của bạn.
Khai báo NavigationEventDispatcher
NavigationEventDispatcher là thành phần trung tâm của thư viện NavigationEvent. Thành phần này đóng vai trò là một trung tâm sự kiện, gửi các sự kiện liên quan đến hoạt động điều hướng (chẳng hạn như cử chỉ quay lại và chuyển đổi điều hướng) đến trình nghe đã đăng ký trong ứng dụng của bạn. Các thành phần có thể đăng ký nhận những sự kiện này để phản ứng với các thay đổi về điều hướng hoặc các hành động điều hướng khác do hệ thống điều khiển.
Bạn nên cung cấp các thực thể NavigationEventDispatcher thông qua một NavigationEventDispatcherOwner. Điều này đảm bảo rằng các phần khác nhau của ứng dụng có thể truy cập vào cùng một trình điều phối và quan sát các sự kiện điều hướng theo cách nhất quán và phối hợp.
class MyComponent: NavigationEventDispatcherOwner { override val navigationEventDispatcher: NavigationEventDispatcher = NavigationEventDispatcher() }
Nếu đang ở trong ComponentActivity, thay vì triển khai trình điều phối của riêng mình, bạn có thể truy xuất trình điều phối được cung cấp cho bạn.
class MyCustomActivity : ComponentActivity() { fun addMyHandler() { // navigationEventDispatcher provided by the ComponentActivity navigationEventDispatcher.addHandler(myNavigationEventHandler) } }
Thêm một NavigationEventInput
Giờ đây, khi đã đăng ký trình xử lý, bạn đã sẵn sàng nhận sự kiện.
Tuy nhiên, bạn cần cung cấp một nguồn mà từ đó các sự kiện được tạo bằng NavigationEventInput.
NavigationEventInput là thành phần dành riêng cho nền tảng, nhận dữ liệu đầu vào thô của hệ thống và dịch dữ liệu đó thành NavigationEvent chuẩn để gửi đến NavigationEventDispatcher.
Ví dụ sau đây là cách triển khai tuỳ chỉnh của NavigationEventInput:
public class MyInput : NavigationEventInput() { @MainThread public fun backStarted(event: NavigationEvent) { dispatchOnBackStarted(event) } @MainThread public fun backProgressed(event: NavigationEvent) { dispatchOnBackProgressed(event) } @MainThread public fun backCancelled() { dispatchOnBackCancelled() } @MainThread public fun backCompleted() { dispatchOnBackCompleted() } }
Tiếp theo, hãy cung cấp dữ liệu đầu vào đó cho trình điều phối:
navigationEventDispatcher.addInput(MyInput())
Dọn dẹp tài nguyên bằng dispose()
Để ngăn chặn rò rỉ bộ nhớ trong giao diện người dùng động, mọi thực thể NavigationEventDispatcher được tạo phải được xoá rõ ràng khỏi hệ phân cấp bằng phương thức dispose() khi thành phần được liên kết với thực thể đó bị huỷ:
navigationEventDispatcher.dispose()
Phương thức dispose() đảm bảo dọn dẹp theo tầng bằng cách xoá lặp lại trình điều phối và tất cả các phần tử con cháu (con và cháu), đảm bảo rằng tất cả trình xử lý liên quan đều được huỷ đăng ký khỏi hệ thống dùng chung.
Hệ thống phân cấp và kiểm soát của trình điều phối
NavigationEventDispatcher hỗ trợ hệ phân cấp mẹ-con, cho phép các thành phần lồng sâu trong giao diện người dùng (chẳng hạn như NavHost hoặc hộp thoại lồng nhau) tham gia vào quá trình xử lý sự kiện điều hướng.
Tạo trình điều phối con
Trình điều phối con được tạo bằng cách truyền tham chiếu đến trình điều phối mẹ trong quá trình xây dựng. Tất cả trình điều phối trong một hệ phân cấp đều dùng chung một NavigationEventProcessor để duy trì thứ tự sự kiện vào sau ra trước (LIFO) trên toàn hệ thống dựa trên mức độ ưu tiên.
Bật tính năng theo hệ thống phân cấp
Trình điều phối bao gồm một thuộc tính isEnabled cho phép nhà phát triển bật hoặc tắt toàn bộ cây con của trình xử lý cùng một lúc.
Khi trình điều phối mẹ bị tắt (isEnabled = false), tất cả trình xử lý liên kết với trình điều phối mẹ đó và mọi trình điều phối con của trình điều phối mẹ đó sẽ bị bỏ qua, bất kể trạng thái bật riêng lẻ của chúng.