การนำทางหมายถึงการโต้ตอบที่ช่วยให้ผู้ใช้ไปยังส่วนต่างๆ เข้าไป และออกจากเนื้อหาต่างๆ ภายในแอป
คอมโพเนนต์การนำทางของ Android Jetpack ประกอบด้วยไลบรารีการนำทาง, ปลั๊กอิน Safe Args Gradle และเครื่องมือที่จะช่วยคุณใช้การนำทางในแอป คอมโพเนนต์การนำทางจะจัดการกรณีการใช้งานการนำทางที่หลากหลาย ตั้งแต่การคลิกปุ่มที่ตรงไปตรงมาไปจนถึงรูปแบบที่ซับซ้อนมากขึ้น เช่น แถบแอปและลิ้นชักการนำทาง
แนวคิดสำคัญ
ตารางต่อไปนี้แสดงภาพรวมของแนวคิดหลักในการนำทางและประเภทหลักๆ ที่คุณใช้เพื่อนำไปใช้
แนวคิด |
วัตถุประสงค์ |
ประเภท |
|---|---|---|
เป็นเจ้าภาพ |
องค์ประกอบ UI ที่มีปลายทางการนำทางปัจจุบัน กล่าวคือ เมื่อผู้ใช้ไปยังส่วนต่างๆ ของแอป แอปจะสลับปลายทางเข้าและออกจากโฮสต์การนำทาง |
|
กราฟ |
โครงสร้างข้อมูลที่กำหนดปลายทางการนำทางทั้งหมดภายในแอปและวิธีเชื่อมต่อเข้าด้วยกัน |
|
ตัวควบคุม |
ผู้ประสานงานส่วนกลางสำหรับการจัดการการนำทางระหว่างจุดหมาย ตัวควบคุมมีเมธอดสำหรับการไปยังส่วนต่างๆ ระหว่างปลายทาง การจัดการ Deep Link การจัดการ Back Stack และอื่นๆ |
|
ปลายทาง |
โหนดในกราฟการนำทาง เมื่อผู้ใช้ไปยังโหนดนี้ โฮสต์จะแสดงเนื้อหาของโหนด |
โดยปกติแล้วจะสร้างขึ้นเมื่อสร้างกราฟการนำทาง |
เส้นทาง |
ระบุปลายทางและข้อมูลที่จำเป็นสำหรับปลายทางนั้นๆ แบบไม่ซ้ำกัน คุณนำทางโดยใช้เส้นทางได้ เส้นทางจะนำคุณไปยังจุดหมาย |
ประเภทข้อมูลที่ทำให้เป็นอนุกรมได้ |
สิทธิประโยชน์และฟีเจอร์
คอมโพเนนต์การนำทางมีประโยชน์และฟีเจอร์อื่นๆ อีกมากมาย ซึ่งรวมถึงสิ่งต่อไปนี้
- ภาพเคลื่อนไหวและการเปลี่ยนภาพ: มีทรัพยากรมาตรฐานสำหรับภาพเคลื่อนไหวและการเปลี่ยนภาพ
- การทำ Deep Link: ใช้และจัดการ Deep Link ที่นำผู้ใช้ไปยังปลายทางโดยตรง
- รูปแบบ UI: รองรับรูปแบบต่างๆ เช่น ลิ้นชักการนำทางและแถบการไปยังส่วนต่างๆ ด้านล่าง โดยใช้การทำงานเพิ่มเติมเพียงเล็กน้อย
- ความปลอดภัยในการกำหนดประเภท: มีการรองรับการส่งข้อมูลระหว่างปลายทางด้วยความปลอดภัยในการกำหนดประเภท
- การรองรับ ViewModel: ช่วยให้สามารถกำหนดขอบเขต
ViewModelไปยังกราฟการนำทางเพื่อแชร์ข้อมูลที่เกี่ยวข้องกับ UI ระหว่างปลายทางของกราฟ - ธุรกรรม Fragment: รองรับและจัดการธุรกรรม Fragment ได้อย่างเต็มรูปแบบ
- ย้อนกลับและขึ้น: จัดการการดำเนินการย้อนกลับและขึ้นอย่างถูกต้องโดยค่าเริ่มต้น
ตัวเลือกเฟรมเวิร์ก
คอมโพเนนต์การนําทางรองรับเฟรมเวิร์กหลัก 2 รายการสําหรับการติดตั้งใช้งานกราฟการนําทาง โดยขึ้นอยู่กับสถาปัตยกรรม UI ของแอป ดังนี้
- Compose: หากแอปสร้างขึ้นด้วย Jetpack Compose ทั้งหมด ให้ใช้ Navigation Compose ปลายทางในกราฟเป็นแบบ Composable
- Fragment: หากแอปใช้ View หรือทั้ง View และ Compose ให้ใช้คอมโพเนนต์การนำทางที่อิงตาม Fragment ปลายทางในกราฟคือส่วนย่อยที่สามารถโฮสต์มุมมองมาตรฐาน, เนื้อหา Compose หรือทั้ง 2 อย่างรวมกัน
สำหรับแอปพลิเคชันที่ย้ายข้อมูลจาก Views ไปยัง Compose กลยุทธ์ที่แนะนำคือการใช้คอมโพเนนต์การนำทางที่อิงตาม Fragment ต่อไปขณะแปลงหน้าจอแต่ละหน้าเป็น Compose เมื่อแทนที่ Fragment ทั้งหมดด้วย Composable แล้ว คุณจะย้ายข้อมูลกราฟการนําทางไปยัง Navigation Compose ได้
ตั้งค่าสภาพแวดล้อม
หากต้องการรวมการรองรับการนำทางในโปรเจ็กต์ ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle ของแอป
Groovy
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21' } dependencies { def nav_version = "2.10.2" // Jetpack Compose Integration implementation "androidx.navigation:navigation-compose:$nav_version" // Views/Fragments Integration implementation "androidx.navigation:navigation-fragment:$nav_version" implementation "androidx.navigation:navigation-ui:$nav_version" // Feature module support for Fragments implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version" // Testing Navigation androidTestImplementation "androidx.navigation:navigation-testing:$nav_version" // JSON serialization library, works with the Kotlin serialization plugin. implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3" }
Kotlin
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments kotlin("plugin.serialization") version "2.0.21" } dependencies { val nav_version = "2.10.2" // Jetpack Compose integration implementation("androidx.navigation:navigation-compose:$nav_version") // Views/Fragments integration implementation("androidx.navigation:navigation-fragment:$nav_version") implementation("androidx.navigation:navigation-ui:$nav_version") // Feature module support for Fragments implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version") // Testing Navigation androidTestImplementation("androidx.navigation:navigation-testing:$nav_version") // JSON serialization library, works with the Kotlin serialization plugin implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3") }
ดูข้อมูลเกี่ยวกับการเพิ่มคอมโพเนนต์สถาปัตยกรรมอื่นๆ ลงในโปรเจ็กต์ได้ที่เพิ่มคอมโพเนนต์ลงในโปรเจ็กต์
ขั้นตอนถัดไป
ดูเอกสารประกอบและแหล่งข้อมูลเพิ่มเติมที่เกี่ยวข้องกับคอมโพเนนต์การนําทางได้ที่แหล่งข้อมูลต่อไปนี้
คู่มือโดยละเอียด
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้โฮสต์การนำทางและ NavController
รวมถึงรายละเอียดเกี่ยวกับวิธีที่โฮสต์การนำทางและ โต้ตอบกับ Compose และเฟรมเวิร์ก UI อื่นๆ ได้ที่
คำแนะนำต่อไปนี้
- สร้างตัวควบคุมการนำทาง: อธิบายวิธีสร้าง
NavController - สร้างกราฟการนำทาง: อธิบายวิธีสร้างโฮสต์การนำทางและกราฟการนำทาง
- ไปยังปลายทาง: แสดงวิธีใช้
NavControllerเพื่อย้ายไปมาระหว่างปลายทางในกราฟ
Codelab
- เรียนรู้เกี่ยวกับ Jetpack Navigation
- Fragment และคอมโพเนนต์การนำทาง
- สร้างแอปแบบปรับอัตโนมัติ พร้อมการนำทางแบบไดนามิก
วิดีโอ
- การไปยังส่วนต่างๆ ของการนำทาง
- แนวทางปฏิบัติแนะนำ 10 ข้อสำหรับการเปลี่ยนไปใช้กิจกรรมเดียว
- กิจกรรมเดียว: เหตุผล เวลา และวิธีการ (Android Dev Summit '18)
- Android Jetpack: Manage UI navigation with navigation controller (Google I/O '18)