ภาพเคลื่อนไหวระหว่างปลายทาง

NavDisplay มีความสามารถด้านภาพเคลื่อนไหวในตัวเพื่อสร้างการเปลี่ยนภาพที่ราบรื่นเมื่อผู้ใช้ไปยังส่วนต่างๆ ของแอป คุณสามารถปรับแต่งภาพเคลื่อนไหวเหล่านี้ทั่วโลกสำหรับ NavDisplay หรือที่ระดับ Scene โดยใช้ข้อมูลเมตา

ทำความเข้าใจความสามารถของภาพเคลื่อนไหวในตัว

NavDisplay ใช้ ContentTransform API เพื่อกำหนดวิธีที่เนื้อหาเคลื่อนไหวระหว่างการนำทาง NavDisplay จะทำให้การเปลี่ยนฉากเป็นภาพเคลื่อนไหวโดยอัตโนมัติเมื่อคีย์ที่ได้มาจากคลาสของฉากปัจจุบันและพร็อพเพอร์ตี้ key มีการเปลี่ยนแปลง เมื่อคีย์นี้เปลี่ยนแปลง NavDisplay จะใช้ ContentTransform สำหรับประเภทการเปลี่ยนภาพ (ไปข้างหน้า ย้อนกลับ หรือย้อนกลับที่คาดการณ์ได้) จากฉากที่เหมาะสมในการเปลี่ยนภาพ หากไม่ได้กำหนด ContentTransform ดังกล่าวไว้ NavDisplay จะกลับไปใช้การเปลี่ยนเริ่มต้นที่เกี่ยวข้อง

ลบล้างทรานซิชันเริ่มต้น

คุณสามารถลบล้างลักษณะการทำงานของภาพเคลื่อนไหวเริ่มต้นได้โดยระบุพารามิเตอร์การเปลี่ยนภาพให้กับ NavDisplay

  • transitionSpec: พารามิเตอร์นี้กำหนด ContentTransform ที่จะใช้เมื่อเพิ่มเนื้อหาลงใน Back Stack (เช่น เมื่อไปยังส่วนต่างๆ ข้างหน้า)
  • popTransitionSpec: พารามิเตอร์นี้กำหนด ContentTransform ที่จะใช้เมื่อนำเนื้อหาออกจาก Back Stack (เช่น เมื่อย้อนกลับ)
  • predictivePopTransitionSpec: พารามิเตอร์นี้กำหนด ContentTransform ที่จะใช้เมื่อเนื้อหาปรากฏขึ้นโดยใช้ท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้

ลบล้างการเปลี่ยนที่ระดับ Scene

คุณสามารถใช้ข้อมูลเมตาเพื่อกำหนดภาพเคลื่อนไหวที่กำหนดเองสำหรับแต่ละฉากได้โดยใช้คีย์ข้อมูลเมตาต่อไปนี้ที่กำหนดโดย NavDisplay

เมื่อระบุไว้ ระบบจะใช้การเปลี่ยนฉากระดับฉากเหล่านี้แทนค่าเริ่มต้นที่เกี่ยวข้องซึ่งตั้งค่าไว้ใน NavDisplay

ข้อมูลโค้ดต่อไปนี้แสดงทั้งการเปลี่ยน NavDisplay ทั่วโลกและการลบล้างที่ระดับ NavEntry แต่ละรายการ

@Serializable
data object ScreenA : NavKey

@Serializable
data object ScreenB : NavKey

@Serializable
data object ScreenC : NavKey

class AnimatedNavDisplayActivity : ComponentActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {

            Scaffold { paddingValues ->

                val backStack = rememberNavBackStack(ScreenA)

                NavDisplay(
                    backStack = backStack,
                    onBack = { backStack.removeLastOrNull() },
                    entryProvider = entryProvider {
                        entry<ScreenA> {
                            ContentOrange("This is Screen A") {
                                Button(onClick = { backStack.add(ScreenB) }) {
                                    Text("Go to Screen B")
                                }
                            }
                        }
                        entry<ScreenB> {
                            ContentMauve("This is Screen B") {
                                Button(onClick = { backStack.add(ScreenC) }) {
                                    Text("Go to Screen C")
                                }
                            }
                        }
                        entry<ScreenC>(
                            metadata = metadata {
                                put(NavDisplay.TransitionKey) {
                                    // Slide new content up, keeping the old content in place underneath
                                    slideInVertically(
                                        initialOffsetY = { it },
                                        animationSpec = tween(1000)
                                    ) togetherWith ExitTransition.KeepUntilTransitionsFinished
                                }
                                put(NavDisplay.PopTransitionKey) {
                                    // Slide old content down, revealing the new content in place underneath
                                    EnterTransition.None togetherWith
                                            slideOutVertically(
                                                targetOffsetY = { it },
                                                animationSpec = tween(1000)
                                            )
                                }
                                put(NavDisplay.PredictivePopTransitionKey) {
                                    // Slide old content down, revealing the new content in place underneath
                                    EnterTransition.None togetherWith
                                            slideOutVertically(
                                                targetOffsetY = { it },
                                                animationSpec = tween(1000)
                                            )
                                }
                            }
                        ) {
                            ContentGreen("This is Screen C")
                        }
                    },
                    transitionSpec = {
                        // Slide in from right when navigating forward
                        slideInHorizontally(initialOffsetX = { it }) togetherWith
                            slideOutHorizontally(targetOffsetX = { -it })
                    },
                    popTransitionSpec = {
                        // Slide in from left when navigating back
                        slideInHorizontally(initialOffsetX = { -it }) togetherWith
                            slideOutHorizontally(targetOffsetX = { it })
                    },
                    predictivePopTransitionSpec = {
                        // Slide in from left when navigating back
                        slideInHorizontally(initialOffsetX = { -it }) togetherWith
                            slideOutHorizontally(targetOffsetX = { it })
                    },
                    modifier = Modifier.padding(paddingValues)
                )
            }
        }
    }
}

รูปที่ 1 แอปที่มีภาพเคลื่อนไหวที่กำหนดเอง

เปลี่ยนรายการการนำทางระหว่างฉาก

ในแอปที่สร้างเลย์เอาต์ที่กำหนดเองโดยใช้ฉาก NavEntry อาจรวมอยู่ในพร็อพเพอร์ตี้ entries ของทั้ง 2 ฉากในระหว่างการเปลี่ยนฉากได้ ภายใน NavDisplay จะยืนยันว่าทุกรายการจะแสดงในฉากอย่างมากที่สุด 1 ฉากในเวลาใดก็ตาม ซึ่งอาจส่งผลให้เกิดการเปลี่ยนฉากที่กระโดดเมื่อฉากที่แสดงผล NavEntry มีการเปลี่ยนแปลง หากต้องการสร้างภาพเคลื่อนไหวของรายการระหว่างฉากต่างๆ อย่างราบรื่น คุณสามารถรวม NavDisplay ไว้ใน SharedTransitionLayout และระบุ SharedTransitionScope ให้กับ NavDisplay ดังที่แสดงในตัวอย่างต่อไปนี้

SharedTransitionLayout {
    NavDisplay(
        // ...
        sharedTransitionScope = this
    )
}

รูปที่ 2 การเปลี่ยนภาพกระโดดเมื่อไม่ส่ง SharedTransitionScope ไปยัง NavDisplay
รูปที่ 3 การเปลี่ยนผ่านที่ราบรื่นเมื่อส่งต่อ SharedTransitionScope ให้กับ NavDisplay