android ActionBar与Menu - 2 - email中ActionBar分析
android ActionBar与Menu - 1 - api demos 学习
android ActionBar与Menu - 2 - email中ActionBar分析
?
这里以Email为例,简单分析一下ActionBar在实际中的应用
上面是在模拟器上登录原生Email的截图
?
这里说一下所谓的原生:
原生不是指大家买来手机之后没有修改过任何内容,软件本身的样子。也不是指google的各种亲儿子本身的样子,因为无论是前者还是后者,最起码都是要经过优化和修复bug的,不是亲儿子那就很有可能进行了整容,让你看不出原来的样子
这里的原生是用google发布的源码编译出来的apk,安装到手机或模拟器上面大家就可以看到
?
我们主要看看Email如何使用ActionBar和menu的
页面可以发现,Email既有AcionBar又有menu,menu被放在了底部,先看ActionBar
Email的主Activity是EmailActivity,我就不画类图了,因为总是画不明白,怕误导大家,所以就用类似堆栈log的形式来介绍
@Overrideprotected void onCreate(Bundle savedInstanceState) { …… initUIController(); ……}private void initUIController() { mUIController = UiUtilities.useTwoPane(this) ? new UIControllerTwoPane(this) : new UIControllerOnePane(this);}
这里初始化了一个UIController,其中的关系是这样的
UIControllerBase为父类,是一个抽象类,下面有两个实现类分别为UIControllerOnePane和UIControllerTwoPane(实在理解不了为什么这么命名。。。)
UIControllerOnePane为手机UI实现,UIControllerTwoPane为平板UI实现,我们这里只考虑UIControllerOnePane
public UIControllerBase(EmailActivity activity) { mActivity = activity; mFragmentManager = activity.getFragmentManager(); mRefreshManager = RefreshManager.getInstance(mActivity); mActionBarController = createActionBarController(activity); if (DEBUG_FRAGMENTS) { FragmentManager.enableDebugLogging(true); }}
这里包含了一个ActionBarController,createActionBarController是抽象方法,下面是UIControllerOnePane的实现
@Overrideprotected ActionBarController createActionBarController(Activity activity) { // For now, we just reuse the same action bar controller used for 2-pane. // We may change it later. return new ActionBarController(activity, activity.getLoaderManager(), activity.getActionBar(), new ActionBarControllerCallback());}
最关键的就是ActionBarController了,它包含ActionBar所有内容
public ActionBarController(Context context, LoaderManager loaderManager, ActionBar actionBar, Callback callback) { mContext = context; mLoaderManager = loaderManager; mActionBar = actionBar; mCallback = callback; mDelayedOperations = new DelayedOperations(Utility.getMainThreadHandler()); mAllFoldersLabel = mContext.getResources().getString( R.string.action_bar_mailbox_list_title); mAccountsSelectorAdapter = new AccountSelectorAdapter(mContext); // Configure action bar. mActionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_HOME | ActionBar.DISPLAY_SHOW_CUSTOM); // Prepare the custom view mActionBar.setCustomView(R.layout.action_bar_custom_view); mActionBarCustomView = (ViewGroup) mActionBar.getCustomView(); // Account spinner mAccountSpinnerContainer = UiUtilities.getView(mActionBarCustomView, R.id.account_spinner_container); mAccountSpinner = UiUtilities.getView(mActionBarCustomView, R.id.account_spinner); mAccountSpinnerDefaultBackground = mAccountSpinner.getBackground(); mAccountSpinnerLine1View = UiUtilities.getView(mActionBarCustomView, R.id.spinner_line_1); mAccountSpinnerLine2View = UiUtilities.getView(mActionBarCustomView, R.id.spinner_line_2); mAccountSpinnerCountView = UiUtilities.getView(mActionBarCustomView, R.id.spinner_count); // Account dropdown mAccountDropdown = new AccountDropdownPopup(mContext); mAccountDropdown.setAdapter(mAccountsSelectorAdapter); mAccountSpinner.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { if (mAccountsSelectorAdapter.getCount() > 0) { mAccountDropdown.show(); } } });}
?从上面可以看出,ActionBar实际上也不复杂,只是设置了显示选项和一个CustomView,复杂的内容几乎全部集中在这个CustomView上了
// Configure action bar.mActionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_HOME | ActionBar.DISPLAY_SHOW_CUSTOM);// Prepare the custom viewmActionBar.setCustomView(R.layout.action_bar_custom_view);mActionBarCustomView = (ViewGroup) mActionBar.getCustomView();
当点击CustomView时候会有弹出下拉框,mAccountDropdown就发挥作用了
private class AccountDropdownPopup extends ListPopupWindow
设置了mAccountSpinner.setOnClickListener,调用到mAccountDropdownshow()
mAccountDropdownshow显示由mAccountsSelectorAdapter提供
public class AccountSelectorAdapter extends CursorAdapter
其中的数据由CursorWithExtras com.android.email.activity.ActionBarController.mCursor提供
mCursor只在一个地方进行刷新,那就是加载账户邮箱信息的时候
/** * Load account/mailbox info, and account/recent mailbox list. */private void loadAccountMailboxInfo(final long accountId, final long mailboxId) { mLoaderManager.restartLoader(LOADER_ID_ACCOUNT_LIST, null, new LoaderCallbacks<Cursor>() { @Override public Loader<Cursor> onCreateLoader(int id, Bundle args) { return AccountSelectorAdapter.createLoader(mContext, accountId, mailboxId); } @Override public void onLoadFinished(Loader<Cursor> loader, Cursor data) { mCursor = (AccountSelectorAdapter.CursorWithExtras) data; updateTitle(); } @Override public void onLoaderReset(Loader<Cursor> loader) { mCursor = null; updateTitle(); } });}
我们可以发现,加载完毕之后Cursor更新了,然后updateTitle,不用去看函数也能猜出这里是更新ActionBar
为了刷新列表,调用了下面语句
mAccountsSelectorAdapter.swapCursor(mCursor);
updateTitle就不再进行分析了,里面几乎都是刷新那个CustomView的内容
?
下面看看底部的菜单,之前的学习中,api demos里并没有演示这种情况,我们用hierarchyviewer查看,发现页面上下都是一个ActionBarContainer的容器
上面的ActionBar我们已经知道它是怎么来的了,那下面的呢?原因在于manifest的配置
?
<activity android:name=".activity.EmailActivity" android:uiOptions="splitActionBarWhenNarrow" ></activity>
splitActionBarWhenNarrow使得ActionBar被拆分成上下两个部分
splitActionBarWhenNarrow用于显示Activity在窄屏设备(如竖屏手机)上运行时的所有menu项。当然,如果手机有menu键的时候,当menu项过多而显示不下的时候按Menu键即可
这时迷题已解,没有什么神秘的地方了,看看menu配置,一目了然
?
<menu xmlns:android="http://schemas.android.com/apk/res/android"> <item android:id="@+id/compose" android:orderInCategory="100" android:alphabeticShortcut="c" android:title="@string/compose_action" android:icon="@drawable/ic_menu_compose_normal_holo_light" android:showAsAction="ifRoom" /> <item android:id="@+id/search" android:orderInCategory="200" android:alphabeticShortcut="s" android:title="@string/search_action" android:icon="@drawable/ic_menu_search_holo_light" android:showAsAction="ifRoom" /> <item android:id="@+id/show_all_mailboxes" android:orderInCategory="300" android:alphabeticShortcut="c" android:title="@string/mailbox_list_account_selector_show_all_folders" android:icon="@drawable/ic_menu_move_to_holo_light" android:showAsAction="ifRoom" /> <item android:id="@+id/refresh" android:orderInCategory="400" android:alphabeticShortcut="r" android:title="@string/refresh_action" android:icon="@drawable/ic_menu_refresh_holo_light" android:showAsAction="ifRoom" /> <!-- Note the order; we want to show them to the right of delete/move --> <item android:id="@+id/newer" android:orderInCategory="1500" android:icon="@drawable/menu_item_newer" android:showAsAction="always" android:visible="false" /> <item android:id="@+id/older" android:orderInCategory="1600" android:icon="@drawable/menu_item_older" android:showAsAction="always" android:visible="false" /> <item android:id="@+id/mailbox_settings" android:orderInCategory="2000" android:title="@string/mailbox_settings_action" android:icon="@android:drawable/ic_menu_preferences" /> <item android:id="@+id/account_settings" android:orderInCategory="3000" android:title="@string/settings_action" android:icon="@android:drawable/ic_menu_preferences" /></menu>
当我们横屏的时候,menu就会跑到上面去了
?
?
下面是带回退导航的
他能使用户回到上一个页面(并不是上一个activity,回到上一个activity可以通过按back键实现)
?
mActionBar.setDisplayOptions(showUp ? ActionBar.DISPLAY_HOME_AS_UP : 0, ActionBar.DISPLAY_HOME_AS_UP);
在之前的refreshInernal中已经设置过了
?
当我们打开或新建一个邮件的时候,页面会跳转到新的activity
public class MessageCompose extends Activity implements OnClickListener, OnFocusChangeListener, DeleteMessageConfirmationDialog.Callback, InsertQuickResponseDialog.Callback
这里我们看到了,页面依然有回退导航,点击之后能回退到上一个页面,当然,不再是当前的activity了
那么它是如何做到的,代码如下
?
@Overridepublic boolean onOptionsItemSelected(MenuItem item) { if (handleCommand(item.getItemId())) { return true; } return super.onOptionsItemSelected(item);}private boolean handleCommand(int viewId) { switch (viewId) { case android.R.id.home: onBack(false /* systemKey */); return true; ……}/** * Handle a tap to the system back key, or the "app up" button in the action bar. * @param systemKey whether or not the system key was pressed */private void onBack(boolean systemKey) { finish(); if (isOpenedFromWithinApp()) { // If opened from within the app, we just close it. return; } if (isOpenedFromWidget() || !systemKey) { // Otherwise, need to open the main screen for the appropriate account. // Note that mAccount should always be set by the time the action bar is set up. startActivity(Welcome.createOpenAccountInboxIntent(this, mAccount.mId)); }}
点击回退导航时,触发的menu是android.R.id.home?
剩下的事情就好办了,这里交给了onBack来处理
?
?
至此Email应用的ActionBar和menu就基本分析完了,如果有不准确的地方还希望大家指正
?
?
最后附上别人的几篇翻译,内容很基础,也比api demos多,值得一看
Android 用户界面---操作栏(Action Bar 一):基本操作
Android 用户界面---操作栏(Action Bar 二):分离式ActionBar与回退导航
Android 用户界面---操作栏(Action Bar 三):ActionView
Android 用户界面---操作栏(Action Bar 四):ActionProvider与Tab
Android 用户界面---操作栏(Action Bar 五):主要是关于样式