全局操作

您可以使用全局操作来创建多个目的地可以使用的通用操作。例如,您可能希望在不同的目的地中,按钮导航到同一个主应用程序屏幕。

全局操作在导航编辑器中由一个指向关联目的地的箭头表示,如图 1 所示。

图 1. 指向嵌套图的全局操作。

创建全局操作

要创建全局操作,请执行以下操作:

  1. 图编辑器中,单击目的地以突出显示它。
  2. 右键单击目的地以显示上下文菜单。
  3. 选择添加操作 > 全局。目的地的左侧将出现一个箭头 ()。
  4. 单击文本选项卡以导航到 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 与全局操作一起使用的信息,请参阅目的地之间传递数据

其他资源

要了解有关导航的更多信息,请参阅以下其他资源。

示例

Codelabs

视频