Android Design Support Library全解:Part 3 NavigationView 抽屉菜单页面-阿里云开发者社区

开发者社区> 开发与运维> 正文

Android Design Support Library全解:Part 3 NavigationView 抽屉菜单页面

简介: Android Design Support Library系列第三弹,NavigationView 抽屉菜单的实现 左侧弹出菜单 抽屉菜单页面是一中很常见的页面设计,虽然有很多第三方库(SlidingMenu)来帮助我们实现该功能,但是如果自己来实现的话,确实是很麻烦的工作。

Android Design Support Library系列第三弹,NavigationView 抽屉菜单的实现

左侧弹出菜单

抽屉菜单页面是一中很常见的页面设计,虽然有很多第三方库(SlidingMenu)来帮助我们实现该功能,但是如果自己来实现的话,确实是很麻烦的工作。在Android Design Support Library中,谷歌官方提供了NavigationView来帮助我们轻松地实现抽屉导菜单页面。

如果读者在使用Android Design Support Library之前有过开发抽屉菜单的开发经验就会知道,之前都是在DrawerLayout中自定义ListView或是LinerLayout来展示内容达到效果,现在只需要在DrawerLayout中加入NavigationView就能实现抽屉菜单的效果。布局如下:

<?xml version="1.0" encoding="utf-8"?>
<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_height="match_parent"
    android:layout_width="match_parent"
    android:fitsSystemWindows="true">

    <!-- 添加内容部分 -->
    <include layout="@layout/content_layout"/>

    <!-- Navigation view -->
    <android.support.design.widget.NavigationView
        android:id="@+id/navigation_view"
        android:layout_height="match_parent"
        android:layout_width="wrap_content"
        android:layout_gravity="start"
        android:fitsSystemWindows="true"
        app:headerLayout="@layout/drawer_header"
        app:menu="@menu/drawer_view"/>

</android.support.v4.widget.DrawerLayout>

其中对于NavigationView有三个属性很关键:

  • app:menu:表示菜单中的内容,是一个Item的列表,我们创建一个标准的menu文件即可;
  • app:headerLayout – 抽屉菜单的头部,展示背景图片和相关文字;
  • android:layout_gravity 代表菜单弹出的方向,必须要设置,一般可以设置Start从x轴始端,也就是左侧弹出,或者是End, 从x轴末端的方向,也就是右侧侧弹出。

在抽屉菜单中添加内容有两种方法:

  1. 在设计时利用提前准备好的menu文件添加菜单内容;
  2. 在运行时利用代码动态添加菜单内容。

在下文中,两种情况都会都为大家介绍。

利用menu文件

第一步,创建menu文件

创建带有menu内容的想XML文档(drawer_view.xml),其内容如下:

<group android:checkableBehavior="single">
        <item
            android:id="@+id/nav_home"
            android:icon="@drawable/ic_drawer_home"
            android:title="@string/nav_home" />
        <item
            android:id="@+id/nav_about"
            android:icon="@drawable/ic_drawer_about"
            android:title="@string/nav_about" />
        <item
            android:id="@+id/nav_settings"
            android:icon="@drawable/ic_drawer_settings"
            android:title="@string/nav_settings" />

        <item
            android:id="@+id/navigation_subheader"
            android:title="@string/nav_sub_header">
            <menu>
                <item
                    android:id="@+id/navigation_sub_item_1"
                    android:icon="@drawable/ic_drawer_about"
                    android:title="@string/nav_sub_item_1" />
                <item
                    android:id="@+id/navigation_sub_item_2"
                    android:icon="@drawable/ic_drawer_home"
                    android:title="@string/nav_sub_item_2" />
            </menu>
        </item>
    </group>
</menu>

注意,对于menu,可以通过设定属性**android:checkableBehavior **来定义菜单选项的响应模式:

  • single – 只有一个Item能被选中(类似radio buttons);
  • all – 所有的Item都可以被选中(类似checkboxes);
  • none –没有Item能被选中。

第二步 创建header layout

从创建另一个XML布局文件(drawer_header.xml)来定义菜单的头部:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="192dp"
    android:background="?attr/colorPrimaryDark"
    android:padding="16dp"
    android:theme="@style/ThemeOverlay.AppCompat.Dark"
    android:orientation="vertical"
    android:gravity="bottom">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Username"
        android:textAppearance="@style/TextAppearance.AppCompat.Body1"/>
</LinearLayout>

很简单都是线性布局,这里就不在细说了。

第三步 引用布局

就像上文提到的,在NavigationView的布局中,使用头部布局和内容布局。

第四部 初始化

在Activity中初始化NavigationView:

private NavigationView mNavigationView;
mNavigationView = (NavigationView) findViewById(R.id.navigation_view);

第五步 设定菜单监听器

设置菜单中的选项被选中后的事件:

//setting up selected item listener
navigationView.setNavigationItemSelectedListener(
       new NavigationView.OnNavigationItemSelectedListener() {
              @Override
              public boolean onNavigationItemSelected(MenuItem menuItem) {
                        menuItem.setChecked(true);
                        mDrawerLayout.closeDrawers();
                        return true;
              }
       });

利用代码,动态添加菜单内容

利用NavigationView对象的getMenu()方法来获取菜单对象,以添加内容:

final Menu menu = navigationView.getMenu();
for (int i = 1; i <= 3; i++) {
    menu.add("Runtime item "+ i);
}

利用Menu对象的子菜单属性,设定SubMenu:

// adding a section and items into it
final SubMenu subMenu = menu.addSubMenu("SubMenu Title");
for (int i = 1; i <= 2; i++) {
    subMenu.add("SubMenu Item " + i);
}

在添加菜单内容之后,需要刷新菜单内容的适配器:

for (int i = 0, count = mNavigationView.getChildCount(); i < count; i++) {
            final View child = mNavigationView.getChildAt(i);
            if (child != null && child instanceof ListView) {
                final ListView menuView = (ListView) child;
                final HeaderViewListAdapter adapter = (HeaderViewListAdapter) menuView.getAdapter();
                final BaseAdapter wrapped = (BaseAdapter) adapter.getWrappedAdapter();
                wrapped.notifyDataSetChanged();
            }
        }

其他注意事项

ActionBarDrawerToggle

如果想监听抽屉菜单的开关状态,可以利用ActionBarDrawerToggle (V7)对象:

/**
     * In case if you require to handle drawer open and close states
     */
    private void setupActionBarDrawerToogle() {

        mDrawerToggle = new ActionBarDrawerToggle(this,                  /* host Activity */
                                                  mDrawerLayout,         /* DrawerLayout object */
                                                  R.string.drawer_open,  /* "open drawer" description */
                                                  R.string.drawer_close  /* "close drawer" description */
        ) {

            /**
             * Called when a drawer has settled in a completely closed state.
             */
            public void onDrawerClosed(View view) {
                Snackbar.make(view, R.string.drawer_close, Snackbar.LENGTH_SHORT).show();
            }

            /**
             * Called when a drawer has settled in a completely open state.
             */
            public void onDrawerOpened(View drawerView) {
                Snackbar.make(drawerView, R.string.drawer_open, Snackbar.LENGTH_SHORT).show();
            }
        };
        mDrawerLayout.setDrawerListener(mDrawerToggle);

    }

ToolBar

利用原有的ActionBar不能实现NavigationView的效果,需要用ToolBar代替:

//在onCreate()方法中调用
private void setupToolbar() {
    //使用ToolBar替换原本的ActionBar
    Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
    setSupportActionBar(toolbar);

    final ActionBar ab = getSupportActionBar();
    if(ab!=null) {
        //设置ToolBar的图标
        ab.setHomeAsUpIndicator(R.drawable.ic_menu);
        //是否展示图标
        ab.setDisplayHomeAsUpEnabled(true);
    }
}

同时注意,Activity要使用无ActionBar的主题,否者ActionBar会和ToolBar冲突:

 <style name="AppTheme" parent="Base.Theme.DesignDemo">
    </style>

    <style name="Base.Theme.DesignDemo" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="colorPrimary">#2196F3</item>
        <item name="colorPrimaryDark">#1976D2</item>
        <item name="colorAccent">#E040FB</item>
        <item name="android:windowBackground">@color/window_background</item>
    </style>

最后还要为ToolBar设定点击事件,在点击菜单Home时,弹出菜单:

@Override
    public boolean onOptionsItemSelected(MenuItem item) {

        int id = item.getItemId();

        switch (id) {
            //当点击Toolbar的Home图标时
            case android.R.id.home:
                mDrawerLayout.openDrawer(GravityCompat.START);
                return true;

            case R.id.action_settings:
                return true;
        }

        return super.onOptionsItemSelected(item);
    }

如果不设定,抽屉菜单将无法弹出。

控制Back键

如果要实现点击Back键后菜单自动消失,还需要控制Back键响应事件:

@Override
    public void onBackPressed() {
        if (isNavDrawerOpen()) {
            closeNavDrawer();
        } else {
            super.onBackPressed();
        }
    }

    protected boolean isNavDrawerOpen() {
        return mDrawerLayout != null && mDrawerLayout.isDrawerOpen(GravityCompat.START);
    }

    protected void closeNavDrawer() {
        if (mDrawerLayout != null) {
            mDrawerLayout.closeDrawer(GravityCompat.START);
        }
    }

在点击Back键之后,先判断NavigationView是否弹出,如果处于打开状态,就关闭NavigationView。

注意我们在布局文件中定义NavigationView的 android:layout_gravity="start",所以打开或者关闭菜单时要使用相应的方向GravityCompat.START。如果都是使用GravityCompat.END,效果就是从右侧弹出菜单。

右侧菜单弹出

更多关于Design Support Library中控件的讲解将会在持续更新,欢迎关注。

最后给出Github源码

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章