android drawerlayout

android的侧边栏有两种实现方式，一是slidemenu，二是drawerlayout，drawerlayout没用过，所以研究了下，官方已经有demo，但是只能4.0以上的，但是可以用v7 jar支持2.1以上的，2.1以上的astionbar会出现菜单没有显示的情况，所以建议还是4.0以上的比较简单

参考：http://blog.csdn.net/xyz_lmn/article/details/12523895

http://blog.csdn.net/crazy1235/article/details/41696291

http://bbs.csdn.net/topics/390877700

Navigation Drawer是从屏幕的左侧滑出，显示应用导航的视图。官方是这样定义的：

[html] view plain copy print ?

Thenavigationdrawerisapanelthatdisplaystheapp’smain
navigationoptionsontheleftedgeofthescreen.Itishidden
mostofthetime,butisrevealedwhentheuserswipesafinger
fromtheleftedgeofthescreenor,whileatthetoplevelofthe
app,theusertouchestheappiconintheactionbar.

如下图指示：

android drawerlayout_第1张图片

Navigation Drawer不同于SlidingDrawer，它不存在可以拖动的handle；它也不同于SlidingMenu，Navigation Drawer滑出时主屏幕视图不一定。Navigation Drawer是覆盖在主视图上的。

Navigation Drawer是Android团对在2013 google IO大会期间更新的Support库（V13）中新加入的重要的功能。实现现Navigation Drawer需要使用最新支持库（V13）的DrawerLayout。Navigation Drawer的设计指南请参考

Navigation Drawerdesign guide。

Create a Drawer Layout

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

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

[java] view plain copy print ?

<android.support.v4.widget.DrawerLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/drawer_layout"
android:layout_width="match_parent"
android:layout_height="match_parent">
<FrameLayout
android:id="@+id/content_frame"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
<ListViewandroid:id="@+id/left_drawer"
android:layout_width="240dp"
android:layout_height="match_parent"
android:layout_gravity="start"
android:choiceMode="singleChoice"
android:divider="@android:color/transparent"
android:dividerHeight="0dp"
android:background="#111"/>
</android.support.v4.widget.DrawerLayout>

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

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

Initialize the Drawer List

在您的Activity中需要先初始化Navigation Drawer内容，根据您的应用需要Navigation Drawer的内容可能不是ListView，可以使用其他View。

在上面的示例中，我们需要给Navigation Drawer的ListView设置一个Adapter来提供数据。如下所示：

[java] view plain copy print ?

publicclassMainActivityextendsActivity{
privateString[]mPlanetTitles;
privateDrawerLayoutmDrawerLayout;
privateListViewmDrawerList;
...
@Override
publicvoidonCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mPlanetTitles=getResources().getStringArray(R.array.planets_array);
mDrawerLayout=(DrawerLayout)findViewById(R.id.drawer_layout);
mDrawerList=(ListView)findViewById(R.id.left_drawer);
//Settheadapterforthelistview
mDrawerList.setAdapter(newArrayAdapter<String>(this,
R.layout.drawer_list_item,mPlanetTitles));
//Setthelist'sclicklistener
mDrawerList.setOnItemClickListener(newDrawerItemClickListener());
...
}
}

上面的代码调用了setOnItemClickListener()函数来接受Navigation Drawer点击事件。下面会介绍如何通过点击Navigation Drawer显示主界面内容。

Handle Navigation Click Events

当用户选择Navigation DrawerList中的条目时，系统会调用 OnItemClickListener的onItemClick()函数。

根据您的应用需要，onItemClick函数的实现方式可能不同。下面的示例中，选择Navigation Drawer条目会在程序主界面中插入不同的Fragment。

[java] view plain copy print ?

privateclassDrawerItemClickListenerimplementsListView.OnItemClickListener{
@Override
publicvoidonItemClick(AdapterViewparent,Viewview,intposition,longid){
selectItem(position);
}
}
/**Swapsfragmentsinthemaincontentview*/
privatevoidselectItem(intposition){
//Createanewfragmentandspecifytheplanettoshowbasedonposition
Fragmentfragment=newPlanetFragment();
Bundleargs=newBundle();
args.putInt(PlanetFragment.ARG_PLANET_NUMBER,position);
fragment.setArguments(args);
//Insertthefragmentbyreplacinganyexistingfragment
FragmentManagerfragmentManager=getFragmentManager();
fragmentManager.beginTransaction()
.replace(R.id.content_frame,fragment)
.commit();
//Highlighttheselecteditem,updatethetitle,andclosethedrawer
mDrawerList.setItemChecked(position,true);
setTitle(mPlanetTitles[position]);
mDrawerLayout.closeDrawer(mDrawerList);
}
@Override
publicvoidsetTitle(CharSequencetitle){
mTitle=title;
getActionBar().setTitle(mTitle);
}

Listen for Open and Close Events

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

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

根据在Navigation Drawer设计指南中的介绍，当菜单显示的时候您应该根据情况隐藏ActionBar上的功能菜单并且修改ActionBar的标题。下面的代码演示了如何重写ActionBarDrawerToggle类的相关函数来实现该功能。

[java] view plain copy print ?

publicclassMainActivityextendsActivity{
privateDrawerLayoutmDrawerLayout;
privateActionBarDrawerTogglemDrawerToggle;
privateCharSequencemDrawerTitle;
privateCharSequencemTitle;
...
@Override
publicvoidonCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
...
mTitle=mDrawerTitle=getTitle();
mDrawerLayout=(DrawerLayout)findViewById(R.id.drawer_layout);
mDrawerToggle=newActionBarDrawerToggle(this,mDrawerLayout,
R.drawable.ic_drawer,R.string.drawer_open,R.string.drawer_close){
/**Calledwhenadrawerhassettledinacompletelyclosedstate.*/
publicvoidonDrawerClosed(Viewview){
getActionBar().setTitle(mTitle);
invalidateOptionsMenu();//createscalltoonPrepareOptionsMenu()
}
/**Calledwhenadrawerhassettledinacompletelyopenstate.*/
publicvoidonDrawerOpened(ViewdrawerView){
getActionBar().setTitle(mDrawerTitle);
invalidateOptionsMenu();//createscalltoonPrepareOptionsMenu()
}
};
//SetthedrawertoggleastheDrawerListener
mDrawerLayout.setDrawerListener(mDrawerToggle);
}
/*CalledwheneverwecallinvalidateOptionsMenu()*/
@Override
publicbooleanonPrepareOptionsMenu(Menumenu){
//Ifthenavdrawerisopen,hideactionitemsrelatedtothecontentview
booleandrawerOpen=mDrawerLayout.isDrawerOpen(mDrawerList);
menu.findItem(R.id.action_websearch).setVisible(!drawerOpen);
returnsuper.onPrepareOptionsMenu(menu);
}
}

Open and Close with the App Icon

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

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

1）显示Navigation Drawer的Activity对象
2）DrawerLayout对象
3）一个用来指示Navigation Drawer的 drawable资源
4）一个用来描述打开Navigation Drawer的文本 (用于支持可访问性)。
5）一个用来描述关闭Navigation Drawer的文本(用于支持可访问性).

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

如下所示：

[java] view plain copy print ?

publicclassMainActivityextendsActivity{
privateDrawerLayoutmDrawerLayout;
privateActionBarDrawerTogglemDrawerToggle;
...
publicvoidonCreate(BundlesavedInstanceState){
...
mDrawerLayout=(DrawerLayout)findViewById(R.id.drawer_layout);
mDrawerToggle=newActionBarDrawerToggle(
this,/*hostActivity*/
mDrawerLayout,/*DrawerLayoutobject*/
R.drawable.ic_drawer,/*navdrawericontoreplace'Up'caret*/
R.string.drawer_open,/*"opendrawer"description*/
R.string.drawer_close/*"closedrawer"description*/
){
/**Calledwhenadrawerhassettledinacompletelyclosedstate.*/
publicvoidonDrawerClosed(Viewview){
getActionBar().setTitle(mTitle);
}
/**Calledwhenadrawerhassettledinacompletelyopenstate.*/
publicvoidonDrawerOpened(ViewdrawerView){
getActionBar().setTitle(mDrawerTitle);
}
};
//SetthedrawertoggleastheDrawerListener
mDrawerLayout.setDrawerListener(mDrawerToggle);
getActionBar().setDisplayHomeAsUpEnabled(true);
getActionBar().setHomeButtonEnabled(true);
}
@Override
protectedvoidonPostCreate(BundlesavedInstanceState){
super.onPostCreate(savedInstanceState);
//SyncthetogglestateafteronRestoreInstanceStatehasoccurred.
mDrawerToggle.syncState();
}
@Override
publicvoidonConfigurationChanged(ConfigurationnewConfig){
super.onConfigurationChanged(newConfig);
mDrawerToggle.onConfigurationChanged(newConfig);
}
@Override
publicbooleanonOptionsItemSelected(MenuItemitem){
//PasstheeventtoActionBarDrawerToggle,ifitreturns
//true,thenithashandledtheappicontouchevent
if(mDrawerToggle.onOptionsItemSelected(item)){
returntrue;
}
//Handleyourotheractionbaritems...
returnsuper.onOptionsItemSelected(item);
}
...
}

Create a Drawer Layout

Initialize the Drawer List

Handle Navigation Click Events

Listen for Open and Close Events

Open and Close with the App Icon

更多相关文章

随机推荐