Android Action Bar (ActionBar) Tab navigation

Action bar (ActionBar) was introduced from API level 11. In this post I will explain how to create actionbar tab navigation using fragments. The final result is shown below where user can move between tabs.
android_actionbar_tab

Creating Android Action bar (ActionBar) with tab navigation

The first step is getting the actionbar 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 {
   List<Fragment> fragList = new ArrayList<Fragment>();
   Fragment f = null;   // Thx to Andre Krause for his support!
   TabFragment tf = null;

    @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 action bar android_actionbar_tab3

Source code available @github

 

 

18 Comments

  1. MartinodF June 19, 2013
  2. survivingwithandroid July 18, 2013
  3. Simon Mayerhofer July 21, 2013
  4. survivingwithandroid July 22, 2013
  5. randomPerson August 15, 2013
  6. survivingwithandroid August 19, 2013
  7. Hannah August 23, 2013
  8. touchwood Inc August 24, 2013
  9. FullFrontal October 1, 2013
  10. Lee Davison October 3, 2013
  11. FullFrontal October 4, 2013
  12. FullFrontal October 4, 2013
  13. Anonymous October 23, 2014
  14. Oliver November 20, 2014
  15. sushant kaura November 29, 2014
  16. Oliver December 12, 2014
  17. nike May 19, 2015
  18. Jim April 26, 2016

Add Comment