使用NavigationUI更新UI组件

导航架构组件包括一个NavigationUI 类。此类包含使用顶部应用栏,导航抽屉和底部导航管理导航的静态方法。

一 听取导航事件

与the进行交互NavController 是在目的地之间导航的主要方法。该NavController 负责更换的内容NavHost 与新的目的地。在许多情况下,UI元素 - 例如顶级应用栏或其他持久性导航控件在BottomNavigationBar外部也是如此 - NavHost需要在目标之间导航时进行更新。

NavController提供了一个OnDestinationChangedListener当被称为接口NavController的当前目标 或它的参数改变。可以通过该addOnDestinationChangedListener() 方法注册新的侦听器 ,如下面的示例所示。请注意,在调用时 addOnDestinationChangedListener(),如果当前目标存在,则会立即将其发送给您的侦听器。

navController.addOnNavigatedListener(new NavController.OnNavigatedListener() {
 @Override
 public void onNavigated(@NonNull NavController navController,
 @NonNull NavDestination destination,
 @Nullable Bundle arguments) {
 textView.setText(destination.getLabel());
 }
});
  

NavigationUI用于OnDestinationChangedListener使这些常见的UI组件具有导航感知功能。但请注意,您也可以单独使用 OnDestinationChangedListener它来使任何自定义UI或业务逻辑了解导航事件。

想学习更多Android知识,或者获取相关资料请加入Android技术开发交流2群:862625886。本群可免费获取Gradle、RxJava、小程序、Hybrid、移动架构、NDK、React Native、性能优化等技术教程!

二 热门应用栏

顶部应用栏应用顶部 提供了一致的位置,用于显示当前屏幕的信息和操作。

NavigationUI包含在用户浏览应用时自动更新顶部应用栏中内容的方法。例如,NavigationUI使用导航图中的目标标签可以使顶部应用栏的标题保持最新。

使用NavigationUI下面讨论的顶级应用栏方法时,可以使用{argName}标签中的格式从提供给目标的参数中自动填充附加到目标的标签。

NavigationUI 提供以下顶级应用栏类型的支持:

1.Toolbar
2.CollapsingToolbarLayout
3.ActionBar
AppBarConfiguration

AppBarConfiguration

NavigationUI使用AppBarConfiguration 对象来管理应用程序显示区域左上角的“导航”按钮的行为。默认情况下,当用户位于导航图的顶级目标位置时,导航按钮将隐藏,并在任何其他目标位置显示为“向上”按钮。

要将导航图的起始目的地用作唯一的顶级目的地,您可以创建一个AppBarConfiguration对象并传入相应的导航图,如下所示:

val appBarConfiguration = AppBarConfiguration(navController.graph)) 

如果要自定义哪些目标被视为顶级目标,则可以将一组目标ID传递给构造函数,如下所示:

val appBarConfiguration = AppBarConfiguration(setOf(R.id.main, R.id.android)) 

三 创建工具栏

要创建工具栏NavigationUI,首先在主活动中定义栏,如下所示:

<LinearLayout>
 <android.support.v7.widget.Toolbar
 android:id="@+id/toolbar" />
 <fragment
 android:id="@+id/nav_host_fragment"
 ... />
 ...
</LinearLayout>

接下来,setupWithNavController() 从您的主要活动的onCreate()方法调用,如下所示:

override fun onCreate(savedInstanceState: Bundle?) {
 setContentView(R.layout.activity_main)
 ...
 val navController = findNavController(R.id.nav_host_fragment)
 val appBarConfiguration = AppBarConfiguration(navController.graph)
 findViewById<Toolbar>(R.id.toolbar)
 .setupWithNavController(navController, appBarConfiguration)
}   
 

注意:使用a时Toolbar,导航会自动处理“导航”按钮的单击事件,因此您无需覆盖onSupportNavigateUp()。

包括CollapsingToolbarLayout

要CollapsingToolbarLayout在工具栏中添加a ,请先在主要活动中定义工具栏和周围布局,如下所示:

<LinearLayout>
 <android.support.design.widget.AppBarLayout
 android:layout_width="match_parent"
 android:layout_height="@dimen/tall_toolbar_height">
 <android.support.design.widget.CollapsingToolbarLayout
 android:id="@+id/collapsing_toolbar_layout"
 android:layout_width="match_parent"
 android:layout_height="match_parent"
 app:contentScrim="?attr/colorPrimary"
 app:expandedTitleGravity="top"
 app:layout_scrollFlags="scroll|exitUntilCollapsed|snap">
 <android.support.v7.widget.Toolbar
 android:id="@+id/toolbar"
 android:layout_width="match_parent"
 android:layout_height="?attr/actionBarSize"
 app:layout_collapseMode="pin"/>
 </android.support.design.widget.CollapsingToolbarLayout>
 </android.support.design.widget.AppBarLayout>
 <fragment
 android:id="@+id/nav_host_fragment"
 ... />
 ...
</LinearLayout>

接下来,setupWithNavController() 从您的主要活动的onCreate方法调用,如下所示

override fun onCreate(savedInstanceState: Bundle?) {
 setContentView(R.layout.activity_main)
 ...
 val layout = findViewById<CollapsingToolbarLayout>(R.id.collapsing_toolbar_layout)
 val toolbar = findViewById<Toolbar>(R.id.toolbar)
 val navController = findNavController(R.id.nav_host_fragment)
 val appBarConfiguration = AppBarConfiguration(navController.graph)
 layout.setupWithNavController(toolbar, navController, appBarConfiguration)
}

四 行动吧

要使用默认操作栏包含导航支持,请setupActionBarWithNavController() 从主活动的onCreate()方法中调用 ,如下所示。请注意,您需要声明您的AppBarConfiguration外部onCreate(),因为您在覆盖时也使用它onSupportNavigateUp():

private lateinit var appBarConfiguration: AppBarConfiguration
...
override fun onCreate(savedInstanceState: Bundle?) {
 ...
 val navController = findNavController(R.id.nav_host_fragment)
 appBarConfiguration = AppBarConfiguration(navController.graph)
 setupActionBarWithNavController(navController, appBarConfiguration)
}

接下来,覆盖onSupportNavigateUp()以处理向上导航:

override fun onSupportNavigateUp(): Boolean {
 return navController.navigateUp(appBarConfiguration) || super.onSupportNavigateUp()
}

五 将目的地绑定到菜单项

NavigationUI还提供了将目标绑定到菜单驱动的UI组件的帮助程序。NavigationUI包含一个辅助方法,onNavDestinationSelected()它MenuItem与NavController托管关联目标的方法 一起使用 。如果id在的MenuItem比赛的id目标时,NavController可以然后导航到目的地。

作为一个例子,下面的XML片断定义一个菜单项,并具有共同的目的地id,details_page_fragment:

<?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"
 ... >
 ...
 <fragment android:id="@+id/details_page_fragment"
 android:label="@string/details"
 android:name="com.example.android.myapp.DetailsFragment" />
</navigation>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
 ...
 <item
 android:id="@id/details_page_fragment"
 android:icon="@drawable/ic_details"
 android:title="@string/details" />
</menu>

onCreateOptionsMenu()例如,如果您的菜单是通过活动添加的,则可以通过覆盖onOptionsItemSelected()要呼叫的活动来将菜单项与目的地相关联onNavDestinationSelected(),如下所示:

override fun onOptionsItemSelected(item: MenuItem): Boolean {
 val navController = findNavController(R.id.nav_host)
 return item.onNavDestinationSelected(navController) || super.onOptionsItemSelected(item)
}

现在,当用户单击details_page_fragment菜单项时,应用程序会自动导航到相应的目标位置id。

六 添加导航抽屉

导航抽屉是一个UI面板,显示应用程序的主导航菜单。当用户触摸

应用栏中的抽屉图标或用户从屏幕的左边缘滑动手指时,抽屉出现 。

抽屉图标显示在使用a的所有顶级目标上DrawerLayout。顶级目标是应用程序的根级目标。它们不会在应用栏中显示“向上”按钮。

要添加导航抽屉,请先将a声明 DrawerLayout为根视图。在其中DrawerLayout,添加主UI内容的布局和包含导航抽屉内容的另一个视图。

例如,以下布局使用DrawerLayout带有两个子视图:a NavHostFragment用于包含主要内容,a NavigationView 用于包含 导航抽屉的内容。

<?xml version="1.0" encoding="utf-8"?>
<!-- Use DrawerLayout as root container for activity -->
<android.support.v4.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"
 xmlns:app="http://schemas.android.com/apk/res-auto"
 android:id="@+id/drawer_layout"
 android:layout_width="match_parent"
 android:layout_height="match_parent"
 android:fitsSystemWindows="true">
 <!-- Layout to contain contents of main body of screen (drawer will slide over this) -->
 <fragment
 android:name="androidx.navigation.fragment.NavHostFragment"
 android:id="@+id/nav_host_fragment"
 android:layout_width="match_parent"
 android:layout_height="match_parent"
 app:defaultNavHost="true"
 app:navGraph="@navigation/nav_graph" />
 <!-- Container for contents of drawer - use NavigationView to make configuration easier -->
 <android.support.design.widget.NavigationView
 android:id="@+id/nav_view"
 android:layout_width="wrap_content"
 android:layout_height="match_parent"
 android:layout_gravity="start"
 android:fitsSystemWindows="true" />
</android.support.v4.widget.DrawerLayout>

接下来,DrawerLayout 通过将其传递到导航图,将其连接到AppBarConfiguration,如下所示:

AppBarConfiguration = new AppBarConfiguration.Builder(navController.getGraph())
.setDrawerLayout(drawerLayout)
.build();

注意:使用时NavigationUI,顶部应用栏帮助器会在当前目标更改时自动在抽屉图标和“向上”图标之间切换。你不需要使用 ActionBarDrawerToggle。

学习更多Android知识,或者获取以上相关资料请加入Android技术开发交流2群:862625886。本群可免费获取Gradle、RxJava、小程序、Hybrid、移动架构、NDK、React Native、性能优化等技术教程!

猜你喜欢

转载自blog.csdn.net/qq_43257419/article/details/86189900