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.TransitionKey: ภาพเคลื่อนไหวการนำทางไปข้างหน้าNavDisplay.PopTransitionKey: ภาพเคลื่อนไหวของการนำทางย้อนกลับNavDisplay.PredictivePopTransitionKey: ภาพเคลื่อนไหวของการย้อนกลับที่คาดการณ์ได้
เมื่อระบุไว้ ระบบจะใช้การเปลี่ยนฉากระดับฉากเหล่านี้แทนค่าเริ่มต้นที่เกี่ยวข้องซึ่งตั้งค่าไว้ใน 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) ) } } } }
เปลี่ยนรายการการนำทางระหว่างฉาก
ในแอปที่สร้างเลย์เอาต์ที่กำหนดเองโดยใช้ฉาก NavEntry อาจรวมอยู่ในพร็อพเพอร์ตี้ entries ของทั้ง 2 ฉากในระหว่างการเปลี่ยนฉากได้ ภายใน NavDisplay จะยืนยันว่าทุกรายการจะแสดงในฉากอย่างมากที่สุด 1 ฉากในเวลาใดก็ตาม ซึ่งอาจส่งผลให้เกิดการเปลี่ยนฉากที่กระโดดเมื่อฉากที่แสดงผล NavEntry มีการเปลี่ยนแปลง หากต้องการสร้างภาพเคลื่อนไหวของรายการระหว่างฉากต่างๆ อย่างราบรื่น คุณสามารถรวม NavDisplay ไว้ใน SharedTransitionLayout และระบุ SharedTransitionScope ให้กับ NavDisplay ดังที่แสดงในตัวอย่างต่อไปนี้
SharedTransitionLayout { NavDisplay( // ... sharedTransitionScope = this ) }
SharedTransitionScope ไปยัง NavDisplaySharedTransitionScope ให้กับ NavDisplay