您的位置：首页 > 移动开发 > Android开发

Android 抽屉导航

2013-07-30 11:53 295 查看
原文地址 http://developer.android.com/training/implementing-navigation/nav-drawer.html

创建抽屉导航

导航抽屉是在 屏幕左侧边缘的 应用主导航选项的面板.
它大多数时间是隐藏的, 但当用户用手指从屏幕的左侧滑动, 或者当用户点击应用顶部工具栏的应用图标的时候, 它就会显示.

此课程是描述 怎样有效的使用在Support Library中的DrawLayout接口 去实现一个导航抽屉.下面是一张效果图：



创建一个抽屉布局

添加一个抽屉, 声明UI的时候需要吧DrawLayout作为你的布局文件的根视图(root view). 在DrawLayout里面, 添加一个主要内容的视图(当抽屉导航隐藏的时候你的主要的布局文件), 和另一个包含导航抽屉的视图.

举例来说, 下面的布局使用了DrawLayout, 它有2个子视图: 一个FrameLayout包含主要的内容, 一个ListView的导航抽屉.

查看源码

打印?

01
<
android.support.v4.widget.DrawerLayout
02
xmlns:android
=
"http://schemas.android.com/apk/res/android"
03
android:id
=
"@+id/drawer_layout"
04
android:layout_width
=
"match_parent"
05
android:layout_height
=
"match_parent"
>
06
<!-- The main content view -->
07
<
FrameLayout
08
android:id
=
"@+id/content_frame"
09
android:layout_width
=
"match_parent"
10
android:layout_height
=
"match_parent"

/>
11
<!-- The navigation drawer -->
12
<
ListView

android:id
=
"@+id/left_drawer"
13
android:layout_width
=
"240dp"
14
android:layout_height
=
"match_parent"
15
android:layout_gravity
=
"start"
16
android:choiceMode
=
"singleChoice"
17
android:divider
=
"@android:color/transparent"
18
android:dividerHeight
=
"0dp"
19
android:background
=
"#111"
/>
20
</
android.support.v4.widget.DrawerLayout
>
这个布局文件示范了一些重要的布局特征.

主要内容的视图(FrameLayout)必须是DrawLayout的第一个子元素, 因为导航抽屉是在主要内容视图的上面.
主要内容视图设置为匹配父视图的宽度和高度, 因为它代表了整个界面导航抽屉是隐藏的.

抽屉视图(ListView)必须指定其水平重力与android:layout_gravity属性。支持从右到左(RTL)语言,指定值与
"start"

代替
"left"
(所以抽屉里出现在布局的右侧当布局是RTL时).

抽屉视图指定其宽度用dp单位和高度匹配父视图。抽屉里的宽度不能超过320 dp, 所以用户总是可以看到主要内容视图的一部分.

初始化抽屉列表
在你的Activity中, 第一件事就是初始化导航抽屉列表里面的元素, 你如何做取决于你的应用程序的内容,但一个导航抽屉通常包括一个ListView, 因此清单应该由一个Adapter填充(例如ArrayAdapter或SimpleCursorAdapter).

例如, 这里演示了如何用String array来初始化一个导航列表.

查看源码

打印?

01
public
 
class
 
MainActivity
extends

Activity {
02
private

String[] mPlanetTitles;
03
private

ListView mDrawerList;
04
...
05
06
@Override
07
public

void
 
onCreate(Bundle savedInstanceState) {
08
super
.onCreate(savedInstanceState);
09
setContentView(R.layout.activity_main);
10
11
mPlanetTitles = getResources().getStringArray(R.array.planets_array);
12
mDrawerList = (ListView) findViewById(R.id.left_drawer);
13
14
// Set the adapter for the list view
15
mDrawerList.setAdapter(
new

ArrayAdapter<String>(
this
,
16
R.layout.drawer_list_item, mPlanetTitles));
17
// Set the list's click listener
18
mDrawerList.setOnItemClickListener(
new

DrawerItemClickListener());
19
20
...
21
}
22
}
这个代码调用setOnItemClickListener()去接收导航抽屉列表的点击事件. 下一节将展示如何实现这个接口,当用户选择一个Item时改变内容视图.

处理导航点击事件
当用户选择了抽屉列表里面的一个Item时, 系统调用onItemClickListener上的onItemClick(), 给setOnItemClickListener().

你在onItemClick()方法里面做什么, 取决于你的app实现的结构.
在下面的例子中, 选择每一个Item都会在主要内容的布局中插入一个不同的Fragment.

查看源码

打印?

01
private
 
class
 
DrawerItemClickListener
implements

ListView.OnItemClickListener {
02
@Override
03
public

void
 
onItemClick(AdapterView parent, View view,
int
 
position,

long
 
id) {
04
selectItem(position);
05
}
06
}
07
08
/** Swaps fragments in the main content view */
09
private
 
void
 
selectItem(
int

position) {
10
// Create a new fragment and specify the planet to show based on position
11
Fragment fragment =
new
 
PlanetFragment();
12
Bundle args =
new
 
Bundle();
13
args.putInt(PlanetFragment.ARG_PLANET_NUMBER, position);
14
fragment.setArguments(args);
15
16
// Insert the fragment by replacing any existing fragment
17
FragmentManager fragmentManager = getFragmentManager();
18
fragmentManager.beginTransaction()
19
   
.replace(R.id.content_frame, fragment)
20
   
.commit();
21
22
// Highlight the selected item, update the title, and close the drawer
23
mDrawer.setItemChecked(position,
true
);
24
setTitle(mPlanetTitles[position]);
25
mDrawerLayout.closeDrawer(mDrawer);
26
}
27
28
@Override
29
public
 
void
 
setTitle(CharSequence title) {
30
mTitle = title;
31
getActionBar().setTitle(mTitle);
32
}
监听打开和关闭事件
侦听抽屉打开和关闭事件,调用你的DrawerLayout setDrawerListener(), 并将其传递给DrawerLayout.DrawerListener的实现. 这个接口提供了回调抽屉事件, 如onDrawerOpened()和onDrawerClosed
()。

然而, 相对于实现DrawerLayout.DrawerListener, 如果你的Activity包括工具栏, 可以代替继承ActionBarDrawerToggle类. ActionBarDrawerToggle实现了DrawerLayout.DrawerListener.
所以你仍然可以覆盖这些回调, 但它也有助于正确的交互行为, 在工具栏的图标和导航抽屉之间(下一节将进一步讨论)。

就像在导航抽屉设计指南一样,当抽屉是可见的时候,你应该修改工具栏的内容, 如改变标题和删除操作Item. 下面的代码用ActionBarDrawerToggle类的一个实例,显示了如何重写DrawerLayout.DrawerListener的回调方法:

查看源码

打印?

01
public
 
class
 
MainActivity
extends

Activity {
02
private

DrawerLayout mDrawerLayout;
03
private

ActionBarDrawerToggle mDrawerToggle;
04
private

CharSequence mDrawerTitle;
05
private

CharSequence mTitle;
06
...
07
08
@Override
09
public

void
 
onCreate(Bundle savedInstanceState) {
10
super
.onCreate(savedInstanceState);
11
setContentView(R.layout.activity_main);
12
...
13
14
mTitle = mDrawerTitle = getTitle();
15
mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout);
16
mDrawerToggle =
new
 
ActionBarDrawerToggle(
this
, mDrawerLayout,
17
R.drawable.ic_drawer, R.string.drawer_open, R.string.drawer_close) {
18
19
/** Called when a drawer has settled in a completely closed state. */
20
public

void
 
onDrawerClosed(View view) {
21
getActionBar().setTitle(mTitle);
22
invalidateOptionsMenu();
// creates call to onPrepareOptionsMenu()
23
}
24
25
/** Called when a drawer has settled in a completely open state. */
26
public

void
 
onDrawerOpened(View drawerView) {
27
getActionBar().setTitle(mDrawerTitle);
28
invalidateOptionsMenu();
// creates call to onPrepareOptionsMenu()
29
}
30
};
31
32
// Set the drawer toggle as the DrawerListener
33
mDrawerLayout.setDrawerListener(mDrawerToggle);
34
}
35
36
/* Called whenever we call invalidateOptionsMenu() */
37
@Override
38
public

boolean
 
onPrepareOptionsMenu(Menu menu) {
39
// If the nav drawer is open, hide action items related to the content view
40
boolean

drawerOpen = mDrawerLayout.isDrawerOpen(mDrawerList);
41
menu.findItem(R.id.action_websearch).setVisible(!drawerOpen);
42
return

super
.onPrepareOptionsMenu(menu);
43
}
44
}
下一节描述ActionBarDrawerToggle构造函数参数和其他所需的步骤来设置它来处理工具栏的图标.

打开关闭应用图标
用户可以打开和关闭导航抽屉, 通过手指从屏幕左侧的边缘滑动, 但如果你使用工具栏, 你应该也能允许用户打开和关闭它, 通过触摸应用程序图标. 应用程序图标也可以显示一个特殊的图标关于导航抽屉的状态.
你可以实现所有这些行为通过使用ActionBarDrawerToggle, 如前一节所示。

让ActionBarDrawerToggle工作, 创建一个它的实例用它的构造方法, 这就需要以下参数:

持有抽屉的Activity.
DrawerLayout对象.
一个Drawable资源作为抽屉指示器.
字符串资源描述"打开抽屉"动作.
字符串资源描述"关闭抽屉"动作.

然后, 无论你是否已经创建了一个ActionBarDrawerToggle的子类作为你的抽屉的Listener, 你需要在几个Activity生命周期的地方,调用你的ActionBarDrawerToggle:

查看源码

打印?

01
public
 
class
 
MainActivity
extends

Activity {
02
private

DrawerLayout mDrawerLayout;
03
private

ActionBarDrawerToggle mDrawerToggle;
04
...
05
06
public

void
 
onCreate(Bundle savedInstanceState) {
07
...
08
09
mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout);
10
mDrawerToggle =
new
 
ActionBarDrawerToggle(
11
this
,
/* host Activity */
12
mDrawerLayout, /* DrawerLayout object */
13
R.drawable.ic_drawer,  /* nav drawer icon to replace 'Up' caret */
14
R.string.drawer_open,  /* "open drawer" description */
15
R.string.drawer_close  /* "close drawer" description */
16
) {
17
18
/** Called when a drawer has settled in a completely closed state. */
19
public void onDrawerClosed(View view) {
20
getActionBar().setTitle(mTitle);
21
}
22
23
/** Called when a drawer has settled in a completely open state. */
24
public

void
 
onDrawerOpened(View drawerView) {
25
getActionBar().setTitle(mDrawerTitle);
26
}
27
};
28
29
// Set the drawer toggle as the DrawerListener
30
mDrawerLayout.setDrawerListener(mDrawerToggle);
31
32
getActionBar().setDisplayHomeAsUpEnabled(
true
);
33
getActionBar().setHomeButtonEnabled(
true
);
34
}
35
36
@Override
37
protected

void
 
onPostCreate(Bundle savedInstanceState) {
38
super
.onPostCreate(savedInstanceState);
39
// Sync the toggle state after onRestoreInstanceState has occurred.
40
mDrawerToggle.syncState();
41
}
42
43
@Override
44
public

void
 
onConfigurationChanged(Configuration newConfig) {
45
super
.onConfigurationChanged(newConfig);
46
mDrawerToggle.onConfigurationChanged(newConfig);
47
}
48
49
@Override
50
public

boolean
 
onOptionsItemSelected(MenuItem item) {
51
// Pass the event to ActionBarDrawerToggle, if it returns
52
// true, then it has handled the app icon touch event
53
if

(mDrawerToggle.onOptionsItemSelected(item)) {
54
  
return

true
;
55
}
56
// Handle your other action bar items...
57
58
return

super
.onOptionsItemSelected(item);
59
}
60
61
...
62
}
来自：http://blog.csdn.net/lc19850921/article/details/8982315
                                            

                                        

                        
                        内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息 
                    

                    

                    

                        

                         标签： 
                                                

                        

                    


                

            


            

                
相关文章推荐

                

                
            

        

        

            

            
            

                

                    
新的分享

                    

                        
                    

                

            


            

                

                    
章节导航