Android ActionBar的基本用法
本文翻译了这篇文章:Using the Android action bar (ActionBar) - Tutorial
1、ActionBar的简介
ActionBar位于Activity的顶部,可用来显示activity的标题、Icon、Actions和一些用于交互的View。它也可被用于应用的导航。
ActionBar 是在Android 3.0(API 11)中加入到SK中的,想在低版本中使用ActionBar有两种选择:使用http://actionbarsherlock.com 或使用Support Library v7。
下面是一张使用ActionBar的界面截图:
其中,[1]是ActionBar的图标,[2]是两个action按钮,[3]是overflow按钮
2、使用ActionBar
开发API11以下的程序,首先必须在AndroidManifest.xml中指定Application或Activity的theme是Theme.Holo或其子类,否则将无法使用ActionBar。
2.1 创建Actions
Actions即ActionBar中的每个交互项,可以在代码中创建Action,也可以在XML文件中指定(位于res/menu)。在menu资源文件中定义Action的方法如下:
showAsAction属性用来定义每个Action是如何显示的,always表示 永远显示在ActionBar中,如果屏幕空间不够则无法显示,ifRoom表示屏幕空间够的情况下显示在ActionBar中,不够的话就显示在overflow中,never则表示永远显示在overflow中。
在Activity中创建ctionBar的Action代码位于onCreateOptionsMenu()中,下面一段代码展示了创建过程:
@Override public boolean onCreateOptionsMenu(Menu menu) { MenuInflater inflater = getMenuInflater(); inflater.inflate(R.menu.mainmenu, menu); return true; }
2.2 Action的按钮交互 如果一个Action被单击,对于activity中的onOptionsItemSelected()将被调用。该函数的传入参数是一个MenuItem。通过判断该MenuItem的Id,即可确认是哪个Action被单击。下面代码展示了该函数的使用过程。
Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { // action with ID action_refresh was selected case R.id.action_refresh: Toast.makeText(this, "Refresh selected", Toast.LENGTH_SHORT) .show(); break; // action with ID action_settings was selected case R.id.action_settings: Toast.makeText(this, "Settings selected", Toast.LENG .show(); break; default: break; } return true; }
onCreateOptionsMenu()只会被调用一次。若想改变Menu,可以调用invalidateOptionsMenu(),这会使onCreateOptionsMenu()将会再次被调用。
3. 自定义ActionBar
3.1 改变ActionBar的显示
在运行时显示和隐藏ActionBar的方法如下:
ActionBar actionBar = getActionBar();actionBar.hide();// more stuff here...actionBar.show();
可以改变显示在程序图标旁边的文字,如下所示: ActionBar actionBar = getActionBar();actionBar.setSubtitle("mytest");actionBar.setTitle("vogella.com");
3.2 隐藏导航按钮 可以使用如下代码隐藏导航按钮。
getWindow(). getDecorView(). setSystemUiVisibility(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION);
3.3 使用全屏模式 对于Android 4.4 (API 19)应用程序可以使用全屏模式,如下面代码所示。
// This method hides the system bars and resize the content private void hideSystemUI() { getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION // hide nav bar | View.SYSTEM_UI_FLAG_FULLSCREEN // hide status bar // remove the following flag for version < API 19 | View.SYSTEM_UI_FLAG_IMMERSIVE); }
3.4 使用Split action bar 在屏幕很窄时(如在portra模式),使用Split action bar可以将所有的action显示在屏幕底部,这样可以讲更有意义的元素如导航、标题等显示在activity的顶部
启用split action bar可在 AndroidManifest.xml中定义android:uiOptions="SplitActionBarWhenNarrow"
4. 在Fragment中给action bar添加action
在onCreate()中调用 setHasOptionsMenu(true)。Android Framework会调用Fragement中的onCreateOptionsMenu()来向Activity的Menu中添加item。
5. 动态设置action bar
5.1. 自定义action bar中显示的View
可以往action bar中添加自定义的View,如button或text。
可以使用ActionView的setCustomView,然后使用setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM)来Enable自定义View。
例子:先定义一个包含了EditText的布局文件。
<?xml version="1.0" encoding="utf-8"?>
下面的代码将上述布局文件添加到了一个Activity的action bar中。 package com.vogella.android.actionbar.customviews;import android.app.ActionBar;import android.app.Activity;import android.os.Bundle;import android.view.KeyEvent;import android.widget.EditText;import android.widget.TextView;import android.widget.TextView.OnEditorActionListener;import android.widget.Toast;public class MainActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); ActionBar actionBar = getActionBar(); // add the custom view to the action bar actionBar.setCustomView(R.layout.actionbar_view); EditText search = (EditText) actionBar.getCustomView().findViewById(R.id.searchfield); search.setOnEditorActionListener(new OnEditorActionListener() { @Override public boolean onEditorAction(TextView v, int actionId, KeyEvent event) { Toast.makeText(MainActivity.this, "Search triggered", Toast.LENGTH_LONG).show(); return false; } }); actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM | ActionBar.DISPLAY_SHOW_HOME); }}
完整的源码下载位置: 自定义Android Action Bar的布局 5.2. Action View
Action View控件可以替换Action bar的Action按钮图标。可以利用这个特点将某个Action项替换成一个ProgressBar。可通过android:actionLayout或android:actionViewClass来定义一个布局文件或Widg来作为Action的action view。
Action View使用的效果图如下。
首先是两个布局文件,第一个用于action view
<?xml version="1.0" encoding="utf-8"?>
第二个用于menu设置
Activity的代码如下: package com.vogella.android.actionbar.progress;import android.app.ActionBar;import android.app.Activity;import android.os.AsyncTask;import android.os.Bundle;import android.view.Menu;import android.view.MenuItem;public class MainActivity extends Activity { private MenuItem menuItem; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); ActionBar actionBar = getActionBar(); actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_HOME | ActionBar.DISPLAY_SHOW_TITLE | ActionBar.DISPLAY_SHOW_CUSTOM); } @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.main, menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case R.id.menu_load: menuItem = item; menuItem.setActionView(R.layout.progressbar); menuItem.expandActionView(); TestTask task = new TestTask(); task.execute("test"); break; default: break; } return true; } private class TestTask extends AsyncTask { @Override protected String doInBackground(String... params) { // Simulate something long running try { Thread.sleep(2000); } catch (InterruptedException e) { e.printStackTrace(); } return null; } @Override protected void onPostExecute(String result) { menuItem.collapseActionView(); menuItem.setActionView(null); } };}
完整源码的下载地址: 动态改变ActionBar的图标 6. Action Provider
Action Provider提供了在单个组件里提供多种交互方式的方法。它可以用来创建action view,动态弹出子menu,处理action调用事件。基类为ActionProvider
目前Android平台提供两种action provider:MediaRouteActionProvider和ShareActionProvider。
下面以一个例子计算ShareActionProvider的用法。使用这个action provider可以让程序从注册了Intent.ACTION_SEND的Intent中获取。
首先定义Menu XML文件,并设置Item的android:actionProviderClass="android.widget.ShareActionProvider"
<?xml version="1.0" encoding="utf-8"?>
设置一个包含了想要共享数据的Intent,将其发送。 @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.activity_main, menu); // Get the ActionProvider for later usage provider = (ShareActionProvider) menu.findItem(R.id.menu_share) .getActionProvider(); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case R.id.menu_share: doShare(); break; default: break; } return true; } public void doShare() { // populate the share intent with data Intent intent = new Intent(Intent.ACTION_SEND); intent.setType("text/plain"); intent.putExtra(Intent.EXTRA_TEXT, "This is a message for you"); provider.setShareIntent(intent); }
7. 使用程序图标导航 7.1. 使用程序图标作为home icon
Action Bar的左侧图标称为home icon,可为这个图标设置一个Action。推荐做法是当按了这个图标,返回到Home Activity中。
下面的代码介绍了在Android4.1前的版本上使用home aciton。关键点是在onOptionsMenuItemSelected() 中使用android.R.id.home并启用actionbar的HomeIcon。SecondActivity将MainActivity作为HomeActivity。
package com.vogella.android.actionbar.homebutton;import android.os.Bundle;import android.app.ActionBar;import android.app.Activity;import android.content.Intent;import android.view.Menu;import android.view.MenuItem;public class SecondActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // enable the home button ActionBar actionBar = getActionBar(); actionBar.setHomeButtonEnabled(true);//或者使用actionBar.setDisplayHomeAsUpEnabled(true); } @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.main, menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case android.R.id.home: Intent intent = new Intent(this, MainActivity.class); intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP); startActivity(intent); break; // Something else case R.id.action_settings: intent = new Intent(this, ThirdActivity.class); startActivity(intent); default: break; } return super.onOptionsItemSelected(item); }}
在Android 4.1以上版本,可以按如下的方式在AndroidManifest.xml中设置parentActivityName属性。 完整代码下载地址: 使用ActionBar的HomeIcon进行导航
上面是关于ActionBar的一些基本用法。由于ActionBar经常会和其它控件如Drawer,Tab等控件联合使用,之后我会写一篇文章介绍ActionBar与其它控件的搭配用法并提供源代码作为备用。
更多相关文章
- Android NFS 文件系统
- Android中VideoView播放当前工程中视频文件的方法
- XML 文件XMLPull
- Android 中颜色对应的代码集合
- 项目文件跟Google学习Android开发-工具篇-Android Studio入门
- 《Android 编程权威指南》(Android Programming The Big Nerd Ran
- Android 文件及文件夹删除
- 美团,大众点评,悬浮窗功能代码