Android的导航抽屉---Navigation Drawer

 2013 Google I/O大会已经过去好几天了，我似乎有点跟不上节奏，也没抽出时间去仔细看一遍，似乎没有想象中那么轰动，，很多同学可能认为，谷歌即使不拿出Android 5.0酸橙派，好歹也会弄个Android 4.3出来装装样子，可是什么都没有，也没有新手机Nexus 5的任何消息，不免有点儿失望。算了，不管干货多与少,对于Android开发者来说，先来看看推出的新功能Navigation Drawer吧。

官网详细说明：http://developer.android.com/design/patterns/navigation-drawer.html

本来想用我蹩脚的E文把官方文档根据自己的翻译一下，可查阅资料过程中发现大牛已经写的很好很详细了，特拿过来跟大家分享一下，下面引用了云在千峰的博文中的一些内容，

下面来介绍下如何使用 DrawerLayout 控件来实现抽屉菜单

创建Drawer Layout

在需要抽屉菜单的界面，用DrawerLayout 作为界面根控件。在DrawerLayout里面第一个View为当前界面主内容；第二个和第三个View为抽屉菜单内容。如果当前界面只需要一个抽屉菜单，则第三个View可以省略。

下面的例子中DrawerLayout里面包含两个View，第一个FrameLayout中是当前界面主要内容显示区域；第二个ListView为抽屉菜单内容。

[html] view plaincopy

1. <android.support.v4.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"  
2.     android:id="@+id/drawer_layout"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="match_parent" >  
5.     <FrameLayout  
6.         android:id="@+id/content_frame"  
7.         android:layout_width="match_parent"  
8.         android:layout_height="match_parent" />  
9.     <ListView  
10.         android:id="@+id/left_drawer"  
11.         android:layout_width="240dp"  
12.         android:layout_height="match_parent"  
13.         android:layout_gravity="start"  
14.         android:background="#111"  
15.         android:choiceMode="singleChoice"  
16.         android:divider="@android:color/transparent"  
17.         android:dividerHeight="0dp" />  
18.   
19. </android.support.v4.widget.DrawerLayout>  

上面的代码中有如下几点需要注意：

• 显示界面主要内容的View (上面的 FrameLayout ) 必须为DrawerLayout的第一个子View， 原因在于 XML 布局文件中的View顺序为Android系统中的 z-ordering顺序，而抽屉必须出现在内容之上。
• 显示界面内容的View宽度和高度设置为和父View一样，原因在于当抽屉菜单不可见的时候，界面内容代表整个界面UI。
• 抽屉菜单 (上面的 ListView) 必须使用android:layout_gravity属性设置水平的 gravity值 .如果要支持 right-to-left (RTL，从右向左阅读)语言 用 "start" 代替 "left" (当在 RTL语言运行时候，菜单出现在右侧，比如阿拉伯语，自右向左，那抽屉菜单就应该自右向左出。  )。
• 抽屉菜单的宽度为 dp 单位而高度和父View一样。抽屉菜单的宽度应该不超过320dp，这样用户可以在菜单打开的时候看到部分内容界面。

初始化抽屉菜单

在您的Activity中需要先初始化抽屉菜单内容，根据您的应用需要抽屉菜单的内容可能不是ListView。官方示例中普通listView加载固定数据的过程就不多说了，和平时一样，没有干货。

监听菜单打开关闭事件

如果需要监听菜单打开关闭事件，则需要调用 DrawerLayout类的 setDrawerListener() 函数，参数为 DrawerLayout.DrawerListener接口的实现。该接口提供了菜单打开关闭等事件的回调函数，例如 onDrawerOpened() 和onDrawerClosed().

如果您的Activity使用了 action bar，则您可以使用Support库提供的 ActionBarDrawerToggle 类，该类实现了 DrawerLayout.DrawerListener接口，并且您还可以根据需要重写相关的函数。该类实现了菜单和Action bar相关的操作。

根据在 Navigation Drawer 设计指南中的介绍，当菜单显示的时候您应该根据情况隐藏ActionBar上的功能菜单并且修改ActionBar的标题。

应用图标指示抽屉开关

用户可以从屏幕边缘滑动来打开抽屉菜单，如果您使用了 action bar，应该让用户通过点击应用图标也可以打开抽屉菜单。并且应用图标也应该使用一个特殊的图标来指示抽屉菜单。您可以使用 ActionBarDrawerToggle 类来实现这些功能。

要使用 ActionBarDrawerToggle ，先通过其构造函数来创建该对象，构造函数需要如下参数：

• 显示抽屉的 Activity 对象
•  DrawerLayout 对象
• 一个用来指示抽屉的 drawable资源
• 一个用来描述打开抽屉的文本 (用于支持可访问性)。
• 一个用来描述关闭抽屉的文本(用于支持可访问性).

无论你是否继承 ActionBarDrawerToggle 来实现抽屉监听器，您都需要在Activity的生命周期函数中调用ActionBarDrawerToggle 的一些函数。

如下所示：

[java] view plaincopy

1. @Override  
2.    protected void onCreate(Bundle savedInstanceState) {  
3.        super.onCreate(savedInstanceState);  
4.        setContentView(R.layout.activity_main);  
5.   
6.        mTitle = mDrawerTitle = getTitle();  
7.        mPlanetTitles = getResources().getStringArray(R.array.planets_array);  
8.        mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout);  
9.        mDrawerList = (ListView) findViewById(R.id.left_drawer);  
10.   
11.        //设置拉出导航菜单时阴影，官方示例不明显，可把图片背景修改一下  
12.        mDrawerLayout.setDrawerShadow(R.drawable.drawer_shadow, GravityCompat.START);  
13.        mDrawerList.setAdapter(new ArrayAdapter<String>(this,  
14.                R.layout.drawer_list_item, mPlanetTitles));  
15.        mDrawerList.setOnItemClickListener(new DrawerItemClickListener());  
16.   
17.        //ActionBar操作模式开启  
18.        getActionBar().setDisplayHomeAsUpEnabled(true);  
19.        getActionBar().setHomeButtonEnabled(true);  
20.   
21.        //初始化 ActionBarDrawerToggle  
22.        mDrawerToggle = new ActionBarDrawerToggle(  
23.                this,                  /* host Activity */  
24.                mDrawerLayout,         /* DrawerLayout object */  
25.                R.drawable.ic_drawer,  /* nav drawer image to replace 'Up' caret */  
26.                R.string.drawer_open,  /* "open drawer" description for accessibility */  
27.                R.string.drawer_close  /* "close drawer" description for accessibility */  
28.                ) {  
29.            public void onDrawerClosed(View view) {  
30.                getActionBar().setTitle(mTitle);  
31.                invalidateOptionsMenu(); // creates call to onPrepareOptionsMenu()  
32.            }  
33.   
34.            public void onDrawerOpened(View drawerView) {  
35.                getActionBar().setTitle(mDrawerTitle);  
36.                invalidateOptionsMenu(); // creates call to onPrepareOptionsMenu()  
37.            }  
38.        };  
39.        mDrawerLayout.setDrawerListener(mDrawerToggle);  
40.   
41.        if (savedInstanceState == null) {  
42.            selectItem(0);  
43.        }  
44.    }  

（官方示例下载）
ps:原文有几点不太明白，希望知道的朋友能指点一下：

1.一个用来描述打开抽屉的文本 (用于支持可访问性)。 

2.当在 RTL语言运行时候，菜单出现在右侧 

这两点应该如何理解？ 

尽管google推出了新的控件，但感觉和 jfeinstein10的开源控件SlidingMenu以及SimonVT的MenuDrawer还是有很大不同之处，虽然Navigation Drawer写法及风格都简单雅致，但对于最求动态效果的用户群来说可能后者更有吸引力，当然，仁者见仁智者见智，以上纯属个人观点,仅供参考。