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

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轴末端的方向，也就是右侧侧弹出。

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

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

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

利用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源码

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

利用menu文件

第一步，创建menu文件

第二步创建header layout

第三步引用布局

第四部初始化

第五步设定菜单监听器

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

其他注意事项

ActionBarDrawerToggle

ToolBar

控制Back键

热门文章

最新文章

相关课程

相关电子书

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

利用menu文件

第一步，创建menu文件

第二步 创建header layout

第三步 引用布局

第四部 初始化

第五步 设定菜单监听器

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

其他注意事项

ActionBarDrawerToggle

ToolBar

控制Back键

热门文章

最新文章

相关课程

相关电子书

第二步创建header layout

第三步引用布局

第四部初始化

第五步设定菜单监听器