นำทางด้วยตัวเลือก

เมื่อคุณกำหนดการดำเนินการในกราฟการนำทางโดยใช้ 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