Android 自定義title 之Action Bar

Android 自定義title 之Action Bar

2014-06-29   飛鷹飛龍...  摘自 博客園  閱 10519  轉 25

轉藏到個人圖書館

 

微信 分享：

Action Bar是在窗口上指示用戶位置的組件，同時給用戶提供導航和操做。使用Action Bar可讓你的應用在不一樣配置的屏幕上看起來比較一致。在開始以前，先了解一些相關的術語： Action Bar有如下幾項關鍵功能： 1）爲你的App提供一個裝飾處，同時也可讓用戶知道本身的所在位置； 2）讓一些重要的操做以一種可預見的方式變得突出而且可訪問（好比搜索）； 3）支持風格一致的導航和視圖切換手段； ActionBar的API首先在Android3.0(API 11)中被加入，可是可使用Support Library使得API 2.1以及以上支持。 這篇文章專一於指引開發者如何使用support library的action bar，可是在Android3.0以及以上的版本中，開發者應該使用框架中的ActionBar。絕大部分的API是同樣的，只有導入的package名字不同。 若是你打算支持比API Level 11低的版本，則導入android.support.v7.app.ActionBar，不然應該導入android.app.ActionBar。   Adding the Action Bar 注意，這裏講述的是如何使用Support Library中的Action Bar。 1）建立Activity，繼承ActionBarActivity； 2）爲Activity設置一個主題； 這樣，你的Activity就已經有了一個action bar了。 備註：在使用Theme.Holo主題的activity中action bar是默認被包含的，而Theme.Holo主題是當targetSdkVersion或者minSdkVersion屬性≥11的時候的默認主題。若是你不想要Activity的action bar，就設置Activity的主題爲Theme.Holo.NoActionBar.設置Activity主題的方式以下： 1 <activity android:theme="@style/Theme.AppCompat.Light" ... >   Removing the action bar 你可使用以下代碼在運行時隱藏ActionBar： 1 ActionBar actionBar = getSupportActionBar();//在API 11或者更高的API上，使用getActionBar方法 2 actionBar.hide(); 當你隱藏了action bar，系統就會調節你的佈局到可用的屏幕的空間，開發者能夠調用show()方法讓action bar出現。 在隱藏和顯示action bar的過程當中，因爲屏幕空間的變化，會致使界面中心佈局。若是你的activity常常顯示/隱藏action bar，你或許會指望使用疊加模式，疊加模式在activity佈局的上層繪製action bar，將其上面的一部分變的模糊起來。這種狀況下，action bar的隱藏和出現不會致使佈局變化，爲了開起疊加模式，須要爲你的activity自定義主題，而且將windowActionBarOverlay設置爲true。   Using a logo instead of an icon 缺省情況下，系統會在ActionBar上使用用你的應用圖標，這個圖標是在你的<application>或者<activity>屬性中指定的，可是若是你寫明瞭<logo>屬性，系統就會使用logo屬性指定的圖片。   Adding Action Items action bar提供了應用當前環境下的重要操做。這些操做排列在action bar上，或者是文字，或者是圖片，稱做action button。排列不下去或者不夠重要的action或被隱藏在actiono verflow中。用戶點擊action overflow的時候隱藏的操做就會顯示出來。 當你的Activity啓動的時候，系統會經過onCreateOptionsMemu()方法初始化你的action items。經過使用這個方法能夠Inflate一個menu res文件。文件定義了全部的action items。例如：文件位置：res/menu/main_activity_actions.xml 1 <menu xmlns:android="http://schemas.android.com/apk/res/android" > 2 <item android:id="@+id/action_search" 3 android:icon="@drawable/ic_action_search" 4 android:title="@string/action_search"/> 5 <item android:id="@+id/action_compose" 6 android:icon="@drawable/ic_action_compose" 7 android:title="@string/action_compose" /> 8 </menu> 而後你能夠在onCreateOptionMenu()中進行以下操做： 1 @Override 2 public boolean onCreateOptionsMenu(Menu menu) { 3 // Inflate the menu items for use in the action bar 4 MenuInflater inflater = getMenuInflater(); 5 inflater.inflate(R.menu.main_activity_actions, menu); 6 return super.onCreateOptionsMenu(menu); 7 } 爲了聲明一個item apperar做爲一個acion button直接顯示在action bar中，咱們須要添加屬性showAsAction="ifRoom"，以下： 1 <menu xmlns:android="http://schemas.android.com/apk/res/android" 2 xmlns:yourapp="http://schemas.android.com/apk/res-auto" > 3 <item android:id="@+id/action_search" 4 android:icon="@drawable/ic_action_search" 5 android:title="@string/action_search" 6 yourapp:showAsAction="ifRoom" /> 7 ... 8 </menu> 這個時候，當空間不夠的時候，action item就會顯示在action overflow中。 備註：showAsAction屬性使用的是自定義的名稱空間，當你使用support library定義的任何XML屬性的時候這是必須的，由於這些屬性不存在於老的Android框架API。因此你必須使用本身定義的名稱空間來=做爲support library所需屬性的前綴。 若是你的menu既提供了title又提供了icon屬性，那麼默認顯示icon，若是你想要顯示文字title，就添加"withText"屬性，以下： 1 <item yourapp:showAsAction="ifRoom|withText" ... /> 備註：「withText」屬性是給action bar的一個暗示，告訴它應該顯示文字title，若是能夠的話，就顯示，可是當icon是可用的而且action bar的空間受到限制的時候，就不必定會顯示了。 你應該爲每個item聲明title屬性，即便你不聲明title要顯示，由於： 1）若是沒有足夠的空間顯示全部的action item，那顯示在overflow中的Item就只會顯示title; 2）視覺受損者會讀取title； 3）若是action item只顯示icon，那麼當用戶長按item的時候，會顯示一個小的提示窗口顯示action的title； icon是可選的，可是推薦使用。 開發者可使用"always"聲明一個Item永遠做爲action button顯示，可是開發者不該該用它迫使item用這種方式顯示，在空間狹小的設備上，這會引發佈局問題。最好的是使用"ifRoom"。這使得系統能夠根據空間作出調整。只有當Item很是重要，關係到關鍵特徵的時候，纔可使用"always"。   Handling clicks on action items 當用戶按下一個action的時候，系統就會調用activity的onOptionsItemSelected()方法，傳遞進去MenuItem參數，而後可使用以下代碼進行相應的處理： 1 @Override 2 public boolean onOptionsItemSelected(MenuItem item) { 3 // Handle presses on the action bar items 4 switch (item.getItemId()) { 5 case R.id.action_search: 6openSearch(); 7 return true; 8 case R.id.action_compose: 9 composeMessage(); 10 return true; 11 default: 12 return super.onOptionsItemSelected(item); 13 } 14 } 備註：最後之因此返回super.onOptionsItemSelected(item);是由於當action bar是由Fragment建立的時候，按下action bar上的action item就會先調用activity的onOptionsItemSelected()，再去調用Fragment的onOptionsItemSelected()方法，爲了讓任何一個fragment的onOptionsItemSelected()始終有機會處理該事件，若是方法不處理該事件，就返回默認行爲，而不要返回false;   Using split action bar 當屏幕空間狹窄的時候，Split action bar在屏幕底部也提供了一條bar來展現action items。這樣分開action bar有助於利用空間安排合理數量的action item。 爲了使用split action bar，咱們必須作兩件事情： 1）給每一個<activity>或者<application>元素添加屬性uiOptions="splitActionBarWhenNarrow" ，這個屬性只在API Level 14或者更高的API level，舊Level會忽略該屬性； 2）爲了支持老版本，須要爲每個<activity>元素添加一個<meta-data>元素，聲明和「android.support.UI_OPTIONS」相同的值； 例子以下： 1 <manifest ...> 2 <activity uiOptions="splitActionBarWhenNarrow" ... > 3 <meta-dataandroid:name="android.support.UI_OPTIONS" 4 android:value="splitActionBarWhenNarrow"/> 5 </activity> 6 </manifest> 使用split action bar也容許在移除icon和title以後，導航Tabs變成主action bar。爲了達到這個效果，必須使用方法setDisplayShowHomeEnabled(false)和 setDisplayShowTitleEnabled(false)action bar icon和title失效。   Navigating Up with the App Icon 讓app icon在界面的繼承關係之間起導航做用。 備註：這個和系統自帶的返回鍵是不同的，返回鍵是爲了讓用戶反向瀏覽歷史打開界面的，它依賴於暫時的界面關係，而不是界面的繼承結構。 爲了使app icon起到Up button的做用，須要調用setDisplayHomeAsUpEnabled()方法： 1 @Override 2 protected void onCreate(Bundle savedInstanceState) { 3 super.onCreate(savedInstanceState); 4 setContentView(R.layout.activity_details); 5 6 ActionBar actionBar = getSupportActionBar(); 7 actionBar.setDisplayHomeAsUpEnabled(true); 8 ... 9 } 如今icon就開始顯示一個Up補字號，然而此時它不會作任何事情，爲了讓它按下的時候出發特定的操做，有如下兩種選擇： 1）在manifest文件中聲明父Activity。 當父Activity老是同樣的時候，這是最佳的選擇，在manifest文件中聲明父Activity，action bar在用戶按下Up button的時候就會自動觸發正確操做。從API 4.1(API Level 16)開始，開發者能夠在<activity>中使用parentActivityName屬性進行聲明，爲了支持使用support library的老設備，須要一個<meta-data>元素來明確，以下： 1 <application ... > 2 ... 3 <!-- The main/home activity (has no parent activity) -->4 <activity 5 android:name="com.example.myfirstapp.MainActivity" ...> 6 ... 7 </activity> 8 <!-- A child of the main activity --> 9 <activity 10 android:name="com.example.myfirstapp.DisplayMessageActivity" 11 android:label="@string/title_activity_display_message" 12 android:parentActivityName="com.example.myfirstapp.MainActivity" > 13<!-- Parent activity meta-data to support API level 7+ --> 14 <meta-data 15 android:name="android.support.PARENT_ACTIVITY" 16 android:value="com.example.myfirstapp.MainActivity" /> 17 </activity> 18 </application> 一旦父Activity在manifest文件被明確，導航就被正確創建起來了。 2）或者，你能夠在Activity中覆寫方法getSupportParentActivityIntent()和onCreateSupportNavigateUpTaskStack()。 當用戶以不一樣的方式達到該界面的時候，可能該界面的父Activity就不肯定了。這個時候用戶須要按照來時的路徑進行回退導航。（雖然前面說和回退鍵不同，可是這裏明顯看出，實際上是同樣的）。 兩個方法都是在系統在用戶須要導航，按下Up button的時候被調用，不一樣的是，前者是在同一個Task中的時候，這個時候你就須要返回響應的intent以便於打開合適的父Activity；後者是這個task不屬於本應用，也就是說是外部的應用打開了你的這個界面，這個時候你就須要使用傳進來的TasjStackBuilder構建適合的back stack來供Up button使用。 即便你爲你的Activity覆寫了getSupportParentActivityIntent()，你也能夠在manifest文件中聲明缺省的父activity，這些缺省的實現就會在缺省的onCreateSupportNavigateUpTaskStack()方法中合成一個回退stack。 備註：若是你使用一系列的fragment而不是activity構建你的app界面樹，上面的作法就沒有同樣會有效。爲了導航fragments，須要重寫onSupportNavigateUp()方法來觸發正確的fragment事務——通常來講，就是將當前的fragment從棧中彈出來，也就是調用popBackStack()   Adding an Action View action view是當你按下一個action button的時候出現的action button的替代視圖。action view在不改變activity或者fragment和不替換action bar的狀況下提供了對富action的快速訪問。示例圖以下： 開發者可使用actionLayout或者actionViewClass屬性來明確一個layout或者widegt類來聲明一個action view，例如，爲了增長一個SearchView widget： 1 <?xml version="1.0" encoding="utf-8"?> 2 <menu xmlns:android="http://schemas.android.com/apk/res/android" 3 xmlns:yourapp="http://schemas.android.com/apk/res-auto" > 4<item android:id="@+id/action_search" 5 android:title="@string/action_search" 6 android:icon="@drawable/ic_action_search" 7 yourapp:showAsAction="ifRoom|collapseActionView" 8 yourapp:actionViewClass="android.support.v7.widget.SearchView" /> 9 </menu> 注意到showAsAction屬性也包括"collapseActionView"值，這是可選的，後面會詳細解釋。 若是你須要配置action view(例如須要監聽事件)，你能夠在onCreateOptionsMenu()回調中實現。你能夠經過調用靜態方法MenuItemCompat.getActionView()得到action view對象，而後將它傳送給響應的MenuItem，舉個例子： 1 @Override 2 public boolean onCreateOptionsMenu(Menu menu) { 3 getMenuInflater().inflate(R.menu.main_activity_actions, menu); 4 MenuItem searchItem = menu.findItem(R.id.action_search); 5 SearchView searchView = (SearchView) MenuItemCompat.getActionView(searchItem); 6 // Configure the search info and add any event listeners 7 ... 8 return super.onCreateOptionsMenu(menu); 9 }    Handling collapsible action views 爲了節省action bar的空間，你能夠將action view壓縮成一個action button。坍縮的時候，系統或許會把action放入action overflow，可是當用戶點擊它的時候，它仍是會出如今action bar上面。開發者能夠經過在showAsAction屬性中添加值"collapseActionView"讓action view可坍縮，就像上面代碼所展現的。 由於當用戶選擇action的時候系統展開了action view，你就不須要響應其onOptionItemSelected()回調，系統仍會調用這個方法，可是當你返回true（表示你已經處理了這個問題），action view就不會展開了。 系統在你按下回退鍵或者Up按鈕的時候也會坍縮你的action view。 若是你須要根據action view的可見性改變activity的界面，你能夠設置一個OnActionExpandListener來監聽，例子以下： 1 @Override 2 public boolean onCreateOptionsMenu(Menu menu) { 3 getMenuInflater().inflate(R.menu.options, menu); 4 MenuItem menuItem = menu.findItem(R.id.actionItem); 5... 6 7 // When using the support library, the setOnActionExpandListener() method is8 // static and accepts the MenuItem object as an argument 9 MenuItemCompat.setOnActionExpandListener(menuItem, new OnActionExpandListener() { 10 @Override 11 public boolean onMenuItemActionCollapse(MenuItem item) { 12 // Do something when collapsed 13 return true; // Return true to collapse action view 14 } 15 16 @Override 17 public boolean onMenuItemActionExpand(MenuItem item) { 18 // Do something when expanded 19 return true; // Return true to expand action view 20 } 21 }); 22 }    Adding an Action Provider 和action view相相似，action provider也是提供一個替代action button的自定義視圖。然而不一樣於action view，action provider控制全部的action行爲，而且能夠在點擊的時候產生一個子menu，示例圖以下： 爲了聲明一個action provider，你能夠在menu<item>標籤裏面爲actionViewClass提供一個完整的ActionProvider的名字。 開發者能夠經過繼承ActionProvider類來實現本身的action provider，可是Android提供了一些內建的providers好比ShareActionProvider，它能夠提供一個能夠分享內容的可能的app的列表。 由於ActionProvider類定義本身的action行爲，你不須要經過onOptionItemSelected()方法區監聽動做。然而若是有必要，你仍是能夠在其中監聽click事件，可是必定要返回false以便於action provider可以收到onPerformDefaultAction()回調來執行實際須要執行的任務。 然而，若是action provider提供了一個action的子menu，那麼你的activity在用戶打開列表或者選擇列表的時候就不會調用onOptionItemSelected()。   Using the ShareActionProvider 爲了使用ShareActionProvider添加一個share action，能夠在<item>標籤中用ShareActionProvider定義actionProviderClass的值，以下： 1 <?xml version="1.0" encoding="utf-8"?> 2 <menu xmlns:android="http://schemas.android.com/apk/res/android" 3 xmlns:yourapp="http://schemas.android.com/apk/res-auto" > 4<item android:id="@+id/action_share" 5 android:title="@string/share" 6 yourapp:showAsAction="ifRoom" 7 yourapp:actionProviderClass="android.support.v7.widget.ShareActionProvider" 8 /> 9 ... 10 </menu> 如今action provider就控制了action item，處理它的顯示隱藏以及行爲。可是你仍是得提供一個title給這個action item以便於它在action overflow中顯示。 生下來的惟一要作的事情就是定義你要用來分享的intent。爲了這樣作，編輯的onCreateOptionMenu()方法，調用方法MenuItemCompat.getActionProvider()，具體以下： 1 private ShareActionProvider mShareActionProvider; 2 3 @Override 4 public boolean onCreateOptionsMenu(Menu menu) { 5 getMenuInflater().inflate(R.menu.main_activity_actions, menu); 6 7 // Set up ShareActionProvider's default share intent 8 MenuItem shareItem = menu.findItem(R.id.action_share); 9 mShareActionProvider = (ShareActionProvider) 10 MenuItemCompat.getActionProvider(shareItem); 11 mShareActionProvider.setShareIntent(getDefaultIntent()); 12 13 return super.onCreateOptionsMenu(menu); 14 } 15 16/** Defines a default (dummy) share intent to initialize the action provider. 17 * However, as soon as the actual content to be used in the intent 18 * is known or changes, you must update the share intent by again calling 19 * mShareActionProvider.setShareIntent() 20 */ 21 private Intent getDefaultIntent() { 22 Intent intent = new Intent(Intent.ACTION_SEND); 23 intent.setType("image/*"); 24 return intent; 25 } 你須要在這個方法裏面設置一個默認的intent，可是一旦上下文環境改變，你就須要經過再次調用setShareIntent()方法更新intent。 缺省的，ShareActionProvider會維持一個能夠分享內容的列表，根據用戶點擊分享的次數排序，缺省狀態下排序信息是被保存在一個叫作DEFAULT_SHARE_FILE_NAME的私有文件中的，若是你使用的是ShareActionProvider或者它的繼承子類，你就可使用默認文件，什麼都不作，可是假如你使用ShareActionProvider來實現多種動做，俺麼就須要本身設置歷史文件，方法是setShareHistoryFileName()，設置一個xml文件的名字。   Creating a custom action provider 建立自定義的action provider容許你在一個獨立的模塊中複用和管理動態的行爲，而不是在你的fragment或者activity中。就像以前提到的，Android已經爲分享行爲提供了一個ActionProvider：ShareActionProvider。 爲了建立本身的action provider，只須要繼承ActionProvider類，而後合適的實現一些回調方法便可。最重要的是如下幾個方法： 1）ActionProvider（） 這個構造方法將APP的Context進來，你須要在這裏保存這個變量以便於在其他的回調函數中使用； 2）CreateActionView（MenuItem） 這裏是你定義action view的地方，使用從構造方法中得到的Context實例化一個LayoutInflater，而後從一個xml資源文件中得到action view佈局，而後添加監聽器，例子以下： 1 public View onCreateActionView(MenuItem forItem) { 2 // Inflate the action view to be shown on the action bar. 3 LayoutInflater layoutInflater = LayoutInflater.from(mContext); 4 View view = layoutInflater.inflate(R.layout.action_provider, null); 5 ImageButton button = (ImageButton) view.findViewById(R.id.button); 6 button.setOnClickListener(new View.OnClickListener() { 7 @Override 8 public void onClick(View v) { 9 // Do something... 10 } 11 }); 12 return view; 13 } 3）onPerformDefaultAction（） 當menu item是在action overflow中被點擊的時候，action provider就會執行一個默認的行爲。 然而，若是action provider提供了一個子menu，在調用了onPrepareSubMenu()方法以後，子menu就會顯示，即便這個時候action provider處於action overflow中，這個時候onPerformDefaultAction()。 備註：實現了onOptionsItemSelected()方法的activity和fragment是能夠經過return true來屏蔽該事件的，這個時候系統就不會調用onPerformDefaultAction()方法了。   Adding Navigation Tabs action bar上的Tabs讓用戶更容易發現和切換應用界面。action bar提供的tabs能夠適應不一樣的屏幕尺寸，於是很是理想。系統會根據屏幕的尺寸作出最合適的佈局。 咱們須要提供一個能夠放置Fragment的ViewGroup。確保ViewGroup有一個資源ID以便於你能夠在代碼中引用和切換tabs的時候容納對應的fragment。若是你的tab填充了整個屏幕，那你的activity就不須要佈局文件了。 一旦你決定好了怎麼在佈局中顯示你的fragments，那麼基本的添加tab的流程就是： 1）實現ActionBar.TabListener接口。這個接口爲tab事件提供了回調接口，好比當用戶按下某個tab的時候你得切換過去； 2）對於每個你要添加的tab，初始化一個ActionBar.Tab而後爲它添加ActionBar.Listener，而後要設置tab的title（也能夠設置它的icon）； 3）而後調用方法addTab()往action bar上面添加tab； 注意到ActionBar.TabListener回調函數並無寫明究竟是哪個fragment被關聯到tab，咱們須要本身定義它們之間的聯繫，也就是說，當用戶點擊一個tab的時候，究竟是顯示哪個tab。下面是一個實例化TabListener的例子：  View Code 注意：開發者不能夠爲fragment事務主動調用commit()事件，不然會拋出異常，由於系統會幫你調用，你也不能將這樣的fragment事務壓進棧中。 在這個例子中，當用戶選擇到這個Tab的時候，就先檢測Fragment是否是Null，是的話就去實例化，添加進ft，不然直接attach，取消選擇的時候則直接調用detach。 如今要作的就是建立一個ActionBar.Tab，而且把監聽器加上去。另外，你必須調用方法setNavigationMode(NAVIGATION_MODE_TABS)來使得tabs可見。 舉例以下，下面的代碼使用上面的listener添加了兩個tabs：  View Code 若是你的activity中止了，你須要在saved instance state中保存當前選中的tab，以便於從新打開的時候能夠跳到正確的tab上去，你可使用方法getSelectedNavigationIndex()方法得到當前選中的tab的index來進行保存。 注意：保存Fragment的狀態是很是重要的，這樣當用戶切換tab以後又回來，就能夠恢復到離開以前的樣子，有些狀態是默認保存的，可是你或許會須要手動保存一些自定的view。 備註：上面實現ActionBar.TabListener是可能的技術之一。另一個流行的方法是使用ViewPager，這樣用戶就能夠經過滑動手勢切換tab。   Adding Drop-down Navigation 做爲activity的一種導航模式，action bar提供了一個內建的下拉列表，舉個例子，下拉列表能夠提供閱覽內容的不一樣排序依據。 當改變閱覽內容是重要的可是不常常發生的動做的時候，使用下拉列表是很是有用的。若是很是頻繁，這個時候就應該使用導航tab。 使用下拉列表的基本步驟是： 1）建立一個SpinnerAdapter來爲下拉列表提供可選擇的item； 2）實現ActionBar.OnNavigationListener來定義當用戶點擊下拉列表框的item的時候的行爲； 3）在activity的onCreate()方法中，使用setNavigationMode(NAVIGATION_MODE_LIST)來激活action bar的下拉列表； 4）爲下拉列表設置參數，方法以下： 1 actionBar.setListNavigationCallbacks(mSpinnerAdapter, mNavigationCallback); 這個方法使用你的SpinnerAdapter和你的OnNavigationListener； 這個流程相對而言是簡單的，主要的工做在於實現SpinnerAdapter和ActionBar.OnNavigationListener。   Styling the Action Bar  若是你想實現一個具備產品特點的視覺設計，action bar是容許你定製顯示細節的，包括action bar的顏色，字體顏色，按鈕風格等等，這就須要你運用Android的style和theme框架來從新設計action bar的特定風格屬性。 注意：請肯定你所提供的任何背景圖片都是.9圖以便於拉伸，.9圖須要≤40dp高，30dp寬 例子以下：  View Code 而後你能夠在你的manifest文件中，將這些主題應用於整個app，方式以下： 1 <application android:theme="@style/CustomActionBarTheme" ... /> 或者應用於單個的activity： 1 <activity android:theme="@style/CustomActionBarTheme" ... /> 注意：任何一個theme和style都要在<style>標籤中聲明一個父theme，這樣就能夠得到一些你沒有設置的參數的默認值。   PS:真是一篇超級冗長的Document，能夠實踐的實在太多了，我打算親自試試~~