เมื่อคุณกำหนดการดำเนินการในกราฟการนำทางโดยใช้ Kotlin DSL การนำทางจะสร้างคลาส NavAction ที่เกี่ยวข้อง ซึ่งมีการกำหนดค่าที่กำหนดไว้สำหรับการดำเนินการนั้น รวมถึงสิ่งต่อไปนี้
- Destination: รหัสทรัพยากรของปลายทางเป้าหมาย
- อาร์กิวเมนต์เริ่มต้น:
android.os.Bundleที่มีค่าเริ่มต้นสำหรับปลายทางเป้าหมาย หากระบุไว้ - ตัวเลือกการนำทาง: ตัวเลือกการนำทางซึ่งแสดงเป็น
NavOptionsคลาสนี้มีการกำหนดค่าพิเศษทั้งหมดสำหรับการเปลี่ยนไปยังและกลับจากปลายทางเป้าหมาย ซึ่งรวมถึงการกำหนดค่าทรัพยากรภาพเคลื่อนไหว ลักษณะการทำงานของป๊อป และการกำหนดว่าควรเปิดปลายทางในโหมด Single Top หรือไม่
ตัวเลือกที่มี Compose
โดยค่าเริ่มต้น navigate() จะเพิ่มปลายทางใหม่ลงใน Back Stack คุณสามารถแก้ไขลักษณะการทำงานของ navigate() ได้โดยส่งตัวเลือกการนำทางเพิ่มเติมไปยังการเรียก navigate()
คุณสร้างอินสแตนซ์ของ NavOptions ได้โดยใช้ Lambda แบบง่าย ส่ง
navigate()อาร์กิวเมนต์ที่คุณอาจส่งไปยัง
NavOptions.Builder อย่างชัดเจน ลองดูตัวอย่างต่อไปนี้
ดูตัวอย่างวิธีส่งตัวเลือกไปยัง navigate() ในบริบทได้ที่คู่มือ Back Stack
ตัวเลือกที่มี XML
ต่อไปนี้เป็นตัวอย่างกราฟที่ประกอบด้วยหน้าจอ 2 หน้าจอพร้อมกับการดำเนินการเพื่อไปยังหน้าจอหนึ่งจากอีกหน้าจอหนึ่ง
<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/nav_graph"
app:startDestination="@id/a">
<fragment android:id="@+id/a"
android:name="com.example.myapplication.FragmentA"
android:label="a"
tools:layout="@layout/a">
<action android:id="@+id/action_a_to_b"
app:destination="@id/b"
app:enterAnim="@anim/nav_default_enter_anim"
app:exitAnim="@anim/nav_default_exit_anim"
app:popEnterAnim="@anim/nav_default_pop_enter_anim"
app:popExitAnim="@anim/nav_default_pop_exit_anim"/>
</fragment>
<fragment android:id="@+id/b"
android:name="com.example.myapplication.FragmentB"
android:label="b"
tools:layout="@layout/b">
<action android:id="@+id/action_b_to_a"
app:destination="@id/a"
app:enterAnim="@anim/nav_default_enter_anim"
app:exitAnim="@anim/nav_default_exit_anim"
app:popEnterAnim="@anim/nav_default_pop_enter_anim"
app:popExitAnim="@anim/nav_default_pop_exit_anim"
app:popUpTo="@+id/a"
app:popUpToInclusive="true"/>
</fragment>
</navigation>
เมื่อกราฟการนําทางขยายออก ระบบจะแยกวิเคราะห์การดําเนินการเหล่านี้ และสร้างออบเจ็กต์ NavAction ที่เกี่ยวข้องด้วยการกําหนดค่าที่กําหนดไว้ในกราฟ เช่น action_b_to_a หมายถึงการนำทางจากจุดหมาย b ไปยังจุดหมาย a การดำเนินการนี้รวมถึงภาพเคลื่อนไหวพร้อมกับลักษณะการทำงาน popTo ที่นำปลายทางทั้งหมดออกจาก Back Stack ระบบจะบันทึกการตั้งค่าทั้งหมดนี้เป็น NavOptions และแนบไว้กับ NavAction
หากต้องการทำตาม NavAction นี้ ให้ใช้ NavController.navigate() โดยส่งรหัสของการดำเนินการ ดังที่แสดงในตัวอย่างต่อไปนี้
navController.navigate(R.id.action_b_to_a)
ใช้ตัวเลือกแบบเป็นโปรแกรม
ตัวอย่างก่อนหน้านี้แสดงวิธีระบุ NavOptions ภายใน XML ของกราฟการนำทาง อย่างไรก็ตาม ตัวเลือกที่เฉพาะเจาะจงอาจแตกต่างกันไปตามข้อจำกัดที่ไม่ทราบในขณะสร้าง ในกรณีเช่นนี้ คุณต้องสร้างและตั้งค่า NavOptions โดยใช้โปรแกรม ดังที่แสดงในตัวอย่างต่อไปนี้
Kotlin
findNavController().navigate(
R.id.action_fragmentOne_to_fragmentTwo,
null,
navOptions { // Use the Kotlin DSL for building NavOptions
anim {
enter = android.R.animator.fade_in
exit = android.R.animator.fade_out
}
}
)
Java
NavController navController = NavHostFragment.findNavController(this);
navController.navigate(
R.id.action_fragmentOne_to_fragmentTwo,
null,
new NavOptions.Builder()
.setEnterAnim(android.R.animator.fade_in)
.setExitAnim(android.R.animator.fade_out)
.build()
);
ตัวอย่างนี้ใช้รูปแบบขยายของ navigate() และมีอาร์กิวเมนต์ Bundle และ NavOptions เพิ่มเติม ตัวแปรทั้งหมดของ navigate() มีเวอร์ชันขยายที่ยอมรับอาร์กิวเมนต์ NavOptions
นอกจากนี้ คุณยังใช้ NavOptions แบบเป็นโปรแกรมได้เมื่อไปยัง Implicit Deep Link ดังนี้
Kotlin
findNavController().navigate(
deepLinkUri,
navOptions { // Use the Kotlin DSL for building NavOptions
anim {
enter = android.R.animator.fade_in
exit = android.R.animator.fade_out
}
}
)
Java
NavController navController = NavHostFragment.findNavController(this);
navController.navigate(
deepLinkUri,
new NavOptions.Builder()
.setEnterAnim(android.R.animator.fade_in)
.setExitAnim(android.R.animator.fade_out)
.build()
);
ตัวแปรของ navigate() นี้ใช้ Uri สำหรับ Implicit Deep Link และอินสแตนซ์ NavOptions