全域動作

您可以使用「全域動作」 來建立多個目的地能使用的共同動作。例如,您可能想要不同目的地中的按鈕前往同一個主要的應用程式畫面。

在「Navigation Editor」(導覽編輯器)中,全域動作以一個指向關聯目的地的小箭頭呈現,如圖 1 所示。

圖 1. 全域動作將使用者導向巢狀結構的圖表。

建立全域動作

如要建立全域動作,請執行下列步驟:

  1. 在「Graph Editor」(圖表編輯器)中,點按一個目的地使其反白。
  2. 在目的地上按一下滑鼠右鍵,即可顯示內容選單。
  3. 依序選取「Add Action」(新增動作) > 「Global」 (全域)。系統會在目的地左側一個顯示箭頭 ()。
  4. 按一下「Text」(文字) 分頁標籤,前往 XML 文字檢視區塊。全域動作的 XML 大致如下所示:

    <?xml version="1.0" encoding="utf-8"?>
    <navigation xmlns:app="http://schemas.android.com/apk/res-auto"
                xmlns:tools="http://schemas.android.com/tools"
                xmlns:android="http://schemas.android.com/apk/res/android"
                android:id="@+id/main_nav"
                app:startDestination="@id/mainFragment">
    
      ...
    
      <action android:id="@+id/action_global_mainFragment"
              app:destination="@id/mainFragment"/>
    
    </navigation>
    

使用全域動作

如要在程式碼中使用全域動作,請將全域動作的資源 ID 傳遞至每個 UI 元素的 navigate() 方法,如以下範例所示:

Kotlin

viewTransactionButton.setOnClickListener { view ->
    view.findNavController().navigate(R.id.action_global_mainFragment)
}

Java

viewTransactionsButton.setOnClickListener(new View.OnClickListener() {
   @Override
   public void onClick(View view) {
       Navigation.findNavController(view).navigate(R.id.action_global_mainFragment);
   }
});

結合全域動作使用 Safe Args

如要瞭解如何結合全域動作使用 Safe Args,請參閱 在目的地之間傳遞資料

其他資源

如要進一步瞭解導航,請參閱下列其他資源。

範例

程式碼研究室

影片