Navigation 是用來管理 App 內畫面之間切換與流程控制的元件，常用於處理 Fragment 或 Jetpack Compose 畫面的導覽。它可以統一管理頁面切換、參數傳遞、返回堆疊，以及深層連結（Deep Link）等功能。
相較於傳統 FragmentTransaction、Bundle 與 Back Stack 等做法，Navigation 提供更結構化且易於維護的方式，能降低程式複雜度，提升可讀性與開發效率。
Navagation 和 intent 的頁面跳轉差在哪裡?Navagation:
==專為 Fragment 導航 而設計==，通常在單一 Activity 應用中使用。Navigation 透過一個導航圖（Navigation Graph） 集中管理頁面之間的切換，讓導航結構清晰易讀。
- Intent:
是 Android 原生的頁面跳轉方式，==適用於 Activity 之間 的導航==，且支援跨應用跳轉。主要依賴 Intent 的參數設定和系統的 Activity 管理來執行跳轉。
NavGraph 的話，系統會跳出警告視窗，選擇確定的話會自動加載相關元件。使用此方法可能會造成 API 等級 錯誤，因此需要調整 API 等級 到指定水平。
>
action，這個 action 代表了我們想從 FragmentA 前往 FragmentB 的動作，我們會在 Controller 使用到他
app:popUpTo: 在導航到新目的地之前，清空回退堆疊直到指定的目的地。例如:當完成某些任務後（如登入），不希望用戶返回前一頁時使用。
- app:popUpToInclusive: 當設為 true 時，會包含 popUpTo 目的地本身一同清除；設為 false 則保留該目的地。通常配合 app:popUpTo 使用，以決定是否保留指定頁面。
- app:enterAnim/app:exitAnim: 定義進入和退出動畫效果，用於頁面切換時的動畫過渡。
- app:popEnterAnim/app:popExitAnim: 定義當回退操作（popBackStack）發生時的進入和退出動畫效果。設置自定義的回退動畫，例如回到上一頁時的淡入淡出效果。
- argument 元素: 在需要傳遞資料（如產品 ID 或用戶資訊）時使用，用於定義從一個頁面傳遞到另一個頁面的參數，支援類型（如 Int、String、Boolean）和預設值。
```xml=
app:launchSingleTop: 設置為 true 時，若當前目的地已在堆疊頂部則不會重新載入新的目的地，防止重複導航。
- app:restoreState: 設置為 true 時，當導航至目的地且該目的地在回退堆疊中時會保留其狀態。例如在切換頁面後返回原頁面時希望保持當前狀態（如滾動位置或輸入框內容）。
NavHostFragment (NavHostFragment 是 Fragment 的子類別)。它通過 NavController 來控制導航操作。
NavHostFragment compoment 並指定要使用的 NavGraph 就好了
- app:navGraph: 指定了 NavHostFragment 使用的導航圖的 ID，該屬性連接導航圖，從而載入導航配置。
- app:defaultNavHost: 設置為 true 時，NavHostFragment 成為應用的預設導航宿主，處理返回按鈕行為，用於當前 Activity 只有一個 NavHostFragment 時，讓 NavHostFragment 處理返回按鈕。
Navigation 的控制器，我們可以使用 NavController 來觸發導航操作負責管理 NavHostFragment 的導航圖，處理各個頁面之間的切換和回退邏輯
- 例如: 從一個 Fragment 跳轉到另一個 Fragment。
- 除了頁面跳轉，還可以做到返回堆疊管理、資料傳遞等。
NavController -- 傳統基礎作法NavHostFragment
```kotlin=
val navHostFragment = requireActivity().supportFragmentManager.findFragmentById(R.id.fragmentContainerView) as NavHostFragment
//NavHostFragment的是Fragment的子類別，因此可以透過requireActivity().supportFragmentManager.findFragmentById()來找到他
```
- 步驟2. 從 NavHostFragment 取得 NavController
```kotlin=
val navController = navHostFragment.navController
```
- 步驟3. 根據需求使用 NavController，例如 Fragment 跳轉
```kotlin=
binding.button1.setOnClickListener {
navController.navigate(R.id.action_fragmentA_to_fragmentB)
}
```
NavController -- 使用 fragment-ktx 擴展函數 的作法Safe Args 傳遞參數
>如果在宣告附加元件時使用警告視窗的自動加載元件的話，fragment-ktx 也會被加載(也就是說 步驟1 可以省略)，[參見](#dependNote)
- 步驟1. 加載 Fragment 的 Ktx 擴展函數
[AndroidDeveloper--Fragment依賴元件](https://developer.android.com/jetpack/androidx/releases/fragment?hl=zh-tw#declaring_dependencies)
```kotlin=
implementation ("androidx.fragment:fragment-ktx:1.8.3")
```
- 步驟2. 直接在需要 NavController 的地方用 findNavController() 方法
```kotlin=
class FragmentA : Fragment() {
private lateinit var binding: FragmentABinding
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?,savedInstanceState: Bundle?): View? {
binding = FragmentABinding.inflate(inflater, container, false)
val navController = findNavController()
binding.button1.setOnClickListener {
navController.navigate(R.id.action_fragmentA_to_fragmentB)
}
return binding.root
}
}
```
NavControllerNavController 的方法和在 Fragment 中略有不同，基本上一樣是從 NavHostFragment 取得，須注意用 ViewBinding 的話，要再加上 getFragment()
```kotlin=
//在Activity取得NavController，A方法
val navHostFragment = supportFragmentManager.findFragmentById(R.id.fragmentContainerView) as NavHostFragment
val navController = navHostFragment.findNavController()
//在Activity取得NavController，B方法
val navHostFragment = binding.fragmentContainerView.getFragmentNavController 中常用的方法navigate(destinationId: Int): 最基本且常見的方法，將使用者導航到指定的目的地。
```kotlin=
navController.navigate(R.id.action_fragmentA_to_fragmentB)
```
- navigateUp(): 嘗試將使用者導引回上一個目的地。如果無法導航回上一個頁面，它會返回 false。
- popBackStack(destinationId: Int, inclusive: Boolean): 從返回堆疊中彈出指定頁面，回到特定的目的地。inclusive 決定是否也彈出 destinationId 自己。
- getBackStackEntry(destinationId: Int): 取得指定目的地的返回堆疊條目，用於從不同頁面共用狀態，例如: 共享 ViewModel。
- currentBackStackEntry: 獲取當前的返回堆疊條目，常用於觀察當前頁面狀態變化，例如: 觀察當前頁面的 LiveData。
```kotlin=
navController.currentBackStackEntry?.savedStateHandle?.getLiveDatanavigate(route: String): 使用字串路由導航（常用於 Compose），比 ID 導航更靈活，可以攜帶動態參數。
```kotlin=
navController.navigate("profile/{userId}")
```
- setGraph(navGraphId: Int): 動態設定或重設導航圖，適合需要依照條件載入不同導航圖的情境，例如多入口點應用。
```kotlin=
navController.setGraph(R.navigation.new_nav_graph)
```
- restoreState(savedState: Bundle?): 將保存的導航狀態恢復到 NavController，常用於在系統重建或頁面重啟時還原導航狀態。
- saveState(): 儲存當前的導航狀態，通常與 restoreState 搭配使用來還原頁面和導航狀態。
popUpTo 中，填入了導航圖本身會怎麼樣?action_fragmentB2_to_fragmentD2 的 popUpTo 屬性上填入導航圖本身(也就是從 nav_graph_a 跳到 nav_graph)，如果當前導航圖本身就在最底部了，那會跳出程式。
