全局操作

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

导航编辑器中全局操作由指向关联目标的小箭头表示,如图 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

视频