Android Dersleri - 1 [ActionBar Kullanımı]

ActionBar Kullanımı – Temel Özellikler

ActionBar kullanıcıya çeşitli eylem ve navigasyon modları sunan bir pencere özelliğidir. Bu pencere özelliği kullanılarak kullanıcılarınıza farklı ekran  konfigürasyonları için uyarlanan tanıdık bir kullanım deneyimi sunabilirsiniz.

ActionBar Genel Bakış

ActionBar temel olarak 4 ana işlevsel alan barındırır. Bunlar app icon(uygulama ikonu), view control, action buttons ve action overflow olarak isimlendirilmektedir.

App Icon: Uygulamaya ait ikon veya logonun yer aldığı bölümdür.

View Control: Uygulama başlığına ayrılmış alandır. Buna ek olarak bu bölge de view ler arası geçişi gerçekleştirmek amacıyla spinner veya tab  navigationda kullanılabilir.

Action Buttons: Uygulamaya ait bazı önemli eylemlerin eklendiği alandır.

Action Overflow: Tüm önemsiz eylem bir menü olarak gösterilir.

Android 3.0 ve altı için ne yapmalıyız ?

ActionBar API ilk olarak Android 3.0 (API 11) ile birlikte sunuldu. Ancak daha sonra eklenen Support Library sayesindeAndroid 2.1 ve üstü ile de uyumlu olarak çalışacak hale getirilmiştir.

Uygulamalarınızda kullanırken dikkat etmeniz gereken nokta,

Eğer API 11 ve altı Android sürümlerinde de  çalışasak bir uygulama geliştiriyorsanız:

import android.support.v7.app.ActionBar

Eğer sadece API 11 ve üstü Android sürümlerinde çalışasak bir uygulama geliştiriyorsanız:

import android.app.ActionBar

Uygulamaya ActionBar Eklenmesi

ActionBar’ ı projeye eklemeden önce appcompat v7 support library ‘ i dahil etmeniz gerekmektedir. Bu işlemi tamamladıktan sonra;

• Oluşturduğunuz activity ActionBarActivity extend etmelidir.
• Activity’ niz için Theme.AppCompattemalarından birini kullanmalısınız.

1	<activity android:theme="@style/Theme.AppCompat.Light" ... >

Şimdi sizin oluşturmuş olduğunuz activity Android 2.1 (API 7) ve üstünde çalışabilecek durumdadır.

ActionBar’ ın Kaldırılması

Runtime sırasında ActionBarı hide()metodunu kullanarak kaldırabilirsiniz.

1 2	ActionBar actionBar = getSupportActionBar(); actionBar.hide();

 Action Item Eklenmesi

1 2 3 4 5 6 7 8

<menu xmlns:android="http://schemas.android.com/apk/res/android"       xmlns:yourapp="http://schemas.android.com/apk/res-auto" >     <item android:id="@+id/action_search"           android:icon="@drawable/ic_action_search"           android:title="@string/action_search"           yourapp:showAsAction="ifRoom"  />     ... </menu>

İlk olarak yukarıda da tanımlanmış olan bazı xml elemanlarını tanıyalım.

android:icon – action elemanı için kullanılacak icon tanımlama.
android:title – icon için kullanılacak başlık.
android:showAsAction – Kullanılan action elemanının görünebilirlik durumunu tanımla. Bu durum için tanımlanabilecek durumlar şunlardır:

ifRoom	Ekran üzerinde gerekli alan mevcut ise icon görünür durumda olacaktır
never	ActionBar da hiçbir zaman icon gösterme
always	Ekranda üzerinde mevcut boş alana bağlı olmadan iconu her zaman göstermeye çalış. () Tavsiye edilmez!
withText	İkon ile birlikte test göster. Normal olarak bu gösterilen text android:title olarak tanımlanır.

ActionBar Click Event Eklenmesi

İlk olarak, res/menu içerisinde yer alan xml dosyasında her bir <item> tag’ i action item içerecek şekilde düzenlenir.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

<menu xmlns:android="http://schemas.android.com/apk/res/android"     xmlns:actionbar="http://schemas.android.com/apk/res-auto" >     <item         android:id="@+id/action_search"         actionbar:showAsAction="ifRoom"         android:icon="@drawable/ic_action_search"         android:title="@string/action_search"/>     <!-- Location Found -->     <item         android:id="@+id/action_location_found"         actionbar:showAsAction="ifRoom"         android:icon="@drawable/ic_action_location_found"         android:title="@string/action_location_found"/>     <!-- Refresh -->     <item         android:id="@+id/action_refresh"         actionbar:showAsAction="ifRoom"         android:icon="@drawable/ic_action_refresh"         android:title="@string/action_refresh"/>     <!-- Help -->     <item         android:id="@+id/action_help"         actionbar:showAsAction="never"         android:icon="@drawable/ic_action_help"         android:title="@string/action_help"/> </menu>

İkinci adımda ise, activity’ i açın ve onOptionsItemSelected() metodunu override edin. Bu metot parametre olarak bir menu item içerir. Seçilen action item id aracılığıyla ayırt edilir. Bu durumu kontrol altında tutmak için switch-case yapısı tercih edilebilir.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

@Override     public boolean onOptionsItemSelected(MenuItem item) {         // TODO Auto-generated method stub         switch (item.getItemId()) {         case R.id.search:             search();             return true;         case R.id.location_found:             location_found();             return true;         case R.id.refresh:             refresh();             return true;         case R.id.help:             help();             return true;         default:             return super.onOptionsItemSelected(item);         }     }

 Split ActionBar Kullanımı

Bölünmüş ActionBar, dar bir ekranda bütün action bar elemanlarının ekranın alt kısımında gösterilmesi demektir. Split ActionBar özelliğinin aktif olması için yapmanız gereken manifest dosyanız içerisinde bütün <activity> taglerinize ve sadece <application> tagi altına uiOptions=”splitActionBarWhenNarrow” eklemektir.  Ayrıca API 14 veya daha altı cihazları desteklemek adına <meta-data>değeri eklemeniz gerekmektedir.(android.support.UI_OPTIONS)

1 2 3 4 5 6

<manifest ...>     <activity uiOptions="splitActionBarWhenNarrow" ... >         <meta-data android:name="android.support.UI_OPTIONS"                    android:value="splitActionBarWhenNarrow" />     </activity> </manifest>

 ActionBar İkonunun Değiştirilmesi

ActionBar içerisinde yer alan uygulama ikonu AndroidManifest dosyası içerisinde yer alan android:icon tanımlı olan görseldir. Bu görseli değiştirmek isterseniz setIcon(drawable) metodunu kullanabilirsiniz.

1 2	ActionBar actionBar=getSupportActionBar(); actionBar.setIcon(R.drawable.ico