Android Core

Android Action Bar with Tab

Action bar was introduced from API level 11. In this post I will explain how to create tab in action bar with fragments. The final result is shown below where user can move between tabs.

Creating the Action bar and the tabs

The first step is getting the action bar reference and add the tab to it:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);   
    ActionBar bar = getActionBar();
    bar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);

    for (int i=1; i <= 3; i++) {
        Tab tab = bar.newTab();
        tab.setText("Tab " + i);
        tab.setTabListener(this);
        bar.addTab(tab);

    }
}

Notice that first of all we don’t use any “main” layout. Second at line 3 we get the reference to the action bar simply using the method getActionBar. At line 4 we set the navigation mode in our case
NAVIGATION_MODE_TABS. There three different navigation type supported:

  • Navigation mode list
  • Navigation mode standard
  • Navigation mode tabs

After these steps we have to create our tabs and add it to the action bar. In our example we create three different tabs. What we want is when user touches one of the tab the UI content changes. To achieve it we need two things:

  • Fragment that fills the UI when user changes the tab according to the tab selected
  • A listener that gets notification when user interacts with the tabs

Tab Fragment

In our example fragment will be very simple, it just shows a text in the middle of the screen. The layout looks like:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <TextView android:id="@+id/msg"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:layout_centerInParent="true"
            />

</RelativeLayout>

While the fragment source code is very simple:

public void onCreate(Bundle savedInstanceState) {        
    super.onCreate(savedInstanceState);
    Bundle data = getArguments();
    index = data.getInt("idx");
}

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
        Bundle savedInstanceState) {

    View v = inflater.inflate(R.layout.fragment, null);
    TextView tv = (TextView) v.findViewById(R.id.msg);
    tv.setText("Fragment " + (index + 1));

    return v;

}

Just notice that we pass the fragment index using arguments bundle (line 2,3).Now we have our fragment we have simply to implement the listener.

Tab listener

We can make our Activity implements the listener so that when user selects a tab we show the relative fragment.

public class MainActivity extends Activity implements TabListener {
...

    @Override
    public void onTabSelected(Tab tab, FragmentTransaction ft) {
        Fragment f = null;
        TabFragment tf = null;

        if (fragList.size() > tab.getPosition())
                fragList.get(tab.getPosition());

        if (f == null) {
            tf = new TabFragment();
            Bundle data = new Bundle();
            data.putInt("idx",  tab.getPosition());
            tf.setArguments(data);
            fragList.add(tf);
        }
        else
            tf = (TabFragment) f;

        ft.replace(android.R.id.content, tf);

    }

    @Override
    public void onTabUnselected(Tab tab, FragmentTransaction ft) {
        if (fragList.size() > tab.getPosition()) {
            ft.remove(fragList.get(tab.getPosition()));
        }

    }
}

TabListener has several methods we have to override. The most important is onTabSelected that is called when user selects a tab. In this method first we check if we have our fragment in the fragment list (line 9-10), if so we reuse it and show the fragment (see line 20). If not, we create our fragment line (12-18) and add it to our fragment list. At the end (line 22), we simply replace the UI content (android.R.id.content) with the right fragment. The result is shown below:

android_actionbar_tab2android_actionbar_tab3

 

Reference: Android Action Bar with Tab from our JCG partner Francesco Azzola at the Surviving w/ Android blog.

Francesco Azzola

He's a senior software engineer with more than 15 yrs old experience in JEE architecture. He's SCEA certified (Sun Certified Enterprise Architect), SCWCD, SCJP. He is an android enthusiast and he has worked for long time in the mobile development field.
Subscribe
Notify of
guest

This site uses Akismet to reduce spam. Learn how your comment data is processed.

9 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
Rajesh
Rajesh
11 years ago

HI ,
I need full source code, can u please send it..

Célio Garcia
Célio Garcia
11 years ago

Hi,

Great tutorial and thanks to share your code.

But it doesn’t work in android 3.x early. Can you please give me the solution for that?

cheers.

Sagar Mundhe
Sagar Mundhe
11 years ago

Thank you for sharing your source code…

Vikram
Vikram
10 years ago

How do i add the the tab bar at the bottom….

Jon
10 years ago

Um, I think your code for TabListener is way off.

`
Fragment f = null;
TabFragment tf = null;

if (fragList.size() > tab.getPosition())
fragList.get(tab.getPosition());

if (f == null) {

`
‘f’ will literally always equal null.

Mahmoud ELshamy
Mahmoud ELshamy
10 years ago

Thanks very much.
It is very simple and clear, you have really helped me

Sushant Kaura
Sushant Kaura
9 years ago

Hi , Thank you for the great tutorial.

What if I want to add a button on layout of fragment 1 that takes me to fragment 3. How can I achieve this? Thank you for your help.

Sushant Kaura

Back to top button