คุณสามารถขยายคลาส Abstract NavigationEventHandler เพื่อจัดการเหตุการณ์การนําทางในแพลตฟอร์มต่างๆ ได้ คลาสนี้มีเมธอดที่สอดคล้องกับวงจรของท่าทางสัมผัสการนำทาง
val myHandler = object: NavigationEventHandler<NavigationEventInfo>( initialInfo = NavigationEventInfo.None, isBackEnabled = true ) { override fun onBackStarted(event: NavigationEvent) { // Prepare for the back event } override fun onBackProgressed(event: NavigationEvent) { // Use event.progress for predictive animations } // This is the required method for final event handling override fun onBackCompleted() { // Complete the back event } override fun onBackCancelled() { // Cancel the back event } }
ฟังก์ชัน addHandler จะเชื่อมต่อแฮนเดิลกับโปรแกรมจ่ายงาน
navigationEventDispatcher.addHandler(myHandler)
เรียก myHandler.remove() เพื่อนำตัวแฮนเดิลออกจากตัวจ่ายงาน
myHandler.remove()
ระบบจะเรียกใช้แฮนเดิลตามลำดับความสำคัญ แล้วจึงเรียกใช้ตามความใหม่ ระบบจะเรียกใช้แฮนเดิล PRIORITY_OVERLAY ทั้งหมดก่อนแฮนเดิล PRIORITY_DEFAULT ภายในกลุ่มลำดับความสำคัญแต่ละกลุ่ม ระบบจะเรียกใช้แฮนเดิลตามลำดับแบบเข้าทีหลังออกก่อน (LIFO) โดยจะเรียกใช้แฮนเดิลที่เพิ่มล่าสุดก่อน
Intercept back with Jetpack Compose
สำหรับ Jetpack Compose ไลบรารีจะมีคอมโพสิเบิลยูทิลิตีเพื่อจัดการลำดับชั้นของตัวจ่ายงาน
NavigationBackHandler Composable จะสร้าง NavigationEventHandler สำหรับเนื้อหาและลิงก์กับ LocalNavigationEventDispatcherOwner โดยจะใช้ DisposableEffect ของ Compose เพื่อเรียกใช้เมธอด dispose() ของ Dispatcher โดยอัตโนมัติเมื่อ Composable ออกจากหน้าจอ ซึ่งจะจัดการทรัพยากรได้อย่างปลอดภัย
@Composable public fun NavigationBackHandler( state: NavigationEventState<out NavigationEventInfo>, isBackEnabled: Boolean = true, onBackCancelled: () -> Unit = {}, onBackCompleted: () -> Unit, ){ }
ฟังก์ชันนี้ช่วยให้คุณควบคุมการจัดการเหตุการณ์ได้อย่างแม่นยำภายในซับทรี UI ที่แปลแล้ว
@Composable fun HandlingBackWithTransitionState( onNavigateUp: () -> Unit ) { val navigationState = rememberNavigationEventState( currentInfo = NavigationEventInfo.None ) val transitionState = navigationState.transitionState // React to predictive back transition updates when (transitionState) { is NavigationEventTransitionState.InProgress -> { val progress = transitionState.latestEvent.progress // Use progress (0f..1f) to update UI during the gesture } is NavigationEventTransitionState.Idle -> { // Reset any temporary UI state if the gesture is cancelled } } NavigationBackHandler( state = navigationState, onBackCancelled = { // Called if the back gesture is cancelled }, onBackCompleted = { // Called when the back gesture fully completes onNavigateUp() } ) }
ตัวอย่างนี้แสดงวิธีสังเกตการอัปเดตท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้โดยใช้ NavigationEventTransitionState คุณใช้ค่า progress เพื่ออัปเดตองค์ประกอบ UI เพื่อตอบสนองต่อท่าทางสัมผัสเพื่อย้อนกลับได้ ขณะที่จัดการการดำเนินการเสร็จสมบูรณ์และการยกเลิกผ่าน NavigationBackHandler
เข้าถึงท่าทางสัมผัสย้อนกลับหรือปัดขอบใน Compose
รูปที่ 1 ภาพเคลื่อนไหวของการย้อนกลับที่คาดการณ์ได้ซึ่งสร้างด้วย NavigationEvent และ Compose
หากต้องการทำให้หน้าจอเคลื่อนไหวขณะที่ผู้ใช้ปัดกลับ คุณจะต้อง (ก) ตรวจสอบว่า NavigationEventTransitionState เป็น InProgress หรือไม่ และ (ข) สังเกตความคืบหน้าและสถานะขอบการปัดด้วย rememberNavigationEventState ดังนี้
progress: ทศนิยมตั้งแต่0.0ถึง1.0ซึ่งระบุระยะทางที่ผู้ใช้ปัดswipeEdge: ค่าคงที่จำนวนเต็ม (EDGE_LEFTหรือEDGE_RIGHT) ที่ระบุตำแหน่งที่ท่าทางสัมผัสเริ่มต้น
ข้อมูลโค้ดต่อไปนี้เป็นตัวอย่างที่เข้าใจง่ายเกี่ยวกับวิธีใช้ภาพเคลื่อนไหวแบบปรับขนาดและเปลี่ยนตำแหน่ง
object Routes { const val SCREEN_A = "Screen A" const val SCREEN_B = "Screen B" } class MainActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContent { var state by remember { mutableStateOf(Routes.SCREEN_A) } val backEventState = rememberNavigationEventState<NavigationEventInfo>(currentInfo = NavigationEventInfo.None) when (state) { Routes.SCREEN_A -> { ScreenA(onNavigate = { state = Routes.SCREEN_B }) } else -> { if (backEventState.transitionState is NavigationEventTransitionState.InProgress) { ScreenA(onNavigate = { }) } ScreenB( backEventState = backEventState, onBackCompleted = { state = Routes.SCREEN_A } ) } } } } } @Composable fun ScreenB( backEventState: NavigationEventState<NavigationEventInfo>, onBackCompleted: () -> Unit = {}, ) { val transitionState = backEventState.transitionState val latestEvent = (transitionState as? NavigationEventTransitionState.InProgress) ?.latestEvent val backProgress = latestEvent?.progress ?: 0f val swipeEdge = latestEvent?.swipeEdge ?: NavigationEvent.EDGE_LEFT if (transitionState is NavigationEventTransitionState.InProgress) { Log.d("BackGesture", "Progress: ${transitionState.latestEvent.progress}") } else if (transitionState is NavigationEventTransitionState.Idle) { Log.d("BackGesture", "Idle") } val animatedScale by animateFloatAsState( targetValue = 1f - (backProgress * 0.1f), label = "ScaleAnimation" ) val windowInfo = LocalWindowInfo.current val density = LocalDensity.current val maxShift = remember(windowInfo, density) { val widthDp = with(density) { windowInfo.containerSize.width.toDp() } (widthDp.value / 20f) - 8 } val offsetX = when (swipeEdge) { NavigationEvent.EDGE_LEFT -> (backProgress * maxShift).dp NavigationEvent.EDGE_RIGHT -> (-backProgress * maxShift).dp else -> 0.dp } NavigationBackHandler( state = backEventState, onBackCompleted = onBackCompleted, isBackEnabled = true ) Box( modifier = Modifier .offset(x = offsetX) .scale(animatedScale) ){ // Rest of UI } }