安卓开发文档学习笔记之实现ActionBar中Tab导航

上篇文章说到如何在安卓项目中添加ActionBar（前文请戳这里），在添加完ActionBar之后，就可以用它做一些更加有趣的事情了，比如这篇文章要说的Tab导航。

首先，上一张官方文档的Tab导航展示图

图1 Tab导航展示
如图所示，Tab导航一般位于ActionBar的下方，通常由三个Tabs组成（当然选项卡的数量是可以自定义的），其中每个Tab关联一个Fragment，通过在不同Tab间的切换，可以实现Fragment的交替显示。
接下来，就是添加Tab导航的详细步骤
1.为ActionBar设置导航模式
ActionBar的导航模式一共有三种（List,Standard,Tabs文档介绍）通过在Activity里调用ActionBar的setNavigationMode()方法来设置具体的导航模式，示例代码如下:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // setContentView(R.layout.activity_main);// 使用Tab导航可以不用设置根视图(root view),文章后面会做解释
    ActionBar actionBar = getSupportActionBar();// 如果不使用Android Support Library, 则调用getActionBar()方法
    actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);// NAVIGATION_MODE_TABS常量表示Tab导航模式
    actionBar.setDisplayShowTitleEnabled(true);// 这里的Title显示的是Activity的android:label属性指定的文字，也就是图1中”Google Play”
　　}

2.添加Tab
先贴示例代码

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // setContentView(R.layout.activity_main);
    ActionBar actionBar = getSupportActionBar();
    actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);
    actionBar.setDisplayShowTitleEnabled(true);

    Tab tab = actionBar.newTab().setText("第一项").setTabListener(this);
    actionBar.addTab(tab);
    tab = actionBar.newTab().setText("第二项").setTabListener(this);
    actionBar.addTab(tab);
    tab = actionBar.newTab().setText("第三项").setTabListener(this);
    actionBar.addTab(tab);
　　}

可以看出，添加一个Tab只需要两个步骤——(1)定义一个Tab对象;(2)调用ActionBar的addTab(Tab tab)方法。但这里需要注意的一点就是Tab事件监听器的设置，Tab导航的事件监听类ActionBar.TabListener总共有三个抽象方法:

@Override
public void onTabSelected(Tab tab, FragmentTransaction ft) {
// Tab选中时要执行的代码
}

@Override
public void onTabUnselected(Tab tab, FragmentTransaction ft) {
// Tab离开选中状态时执行的代码
}
@Override
public void onTabReselected(Tab tab, FragmentTransaction ft) {
// Tab被选中后用户再次选中该Tab所执行的代码，通常不做任何事情
}

这三个方法需要注意的是FragmentTransaction参数的使用(文档介绍)。往FragmentTransaction添加Fragment可以用两种方法add()或者attach()，add()有三个重载方法，但这里我们只看add(int containerViewId, Fragment fragment, [String tag])里的第一个参数containerViewId，根据名字可以知道这个参数表示Fragment所在容器ViewGroup的Id。也就是说，在Activity调用setContentView()所设置的根视图里，至少要包含一个ViewGroup，并且该ViewGroup需要有一个id。但是如果是Fragment所要展示的内容会填满整个Tab，那么就可以省去setContentView()方法，并用android.R.id.content来设置containerViewId，如下面代码所示:

@Override
public void onTabSelected(Tab tab, FragmentTransaction ft) {
    switch (tab.getPosition()) {
    case 0:
        BlackFragment bf = new BlackFragment();
        ft.add(android.R.id.content, bf);
//      ft.commit();
        break;
    case 1:
        GreenFragment gf = new GreenFragment();
        ft.add(android.R.id.content, gf);
//      ft.commit();
        break;
    case 2:
        WhiteFragment wf = new WhiteFragment();
        ft.add(android.R.id.content, wf);
//      ft.commit();
        break;
    default:
        break;
    }
}

因为系统会自动调用ft.commit()方法，所以这里再次调用的话会抛出java.lang.IllegalStateException。同时如果希望在Tab切换时Fragment能保存上一次离开时的状态，那么应该使用attach(Fragment fragment)方法，关于add()和attach()详细的使用方法，请参考文档介绍。
下面是Fragment代码和三张Tab导航的效果图

  
  

   
   全选<button href="javascript:void(0);" _xhe_href="javascript:void(0);" class="copyCode btn btn-xs" data-clipboard-text="" public="" blackfragment="" extends="" fragment="" {"="" data-toggle="tooltip" data-placement="bottom" title="" style="color: rgb(255, 255, 255); font-style: inherit; font-variant: inherit; font-stretch: inherit; font-size: 12px; line-height: 1.5; font-family: inherit; margin: 0px 0px 0px 5px; overflow: visible; cursor: pointer; vertical-align: middle; border: 1px solid transparent; white-space: nowrap; padding-right: 5px; padding-left: 5px; border-radius: 3px; -webkit-user-select: none; box-shadow: rgba(0, 0, 0, 0.0980392) 0px 1px 2px; background-image: none; background-color: rgba(0, 0, 0, 0.74902);">复制
   
   放进笔记
  
  
public class BlackFragment extends Fragment {
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState) {
        LinearLayout colorLayout = new LinearLayout(getActivity());
        LinearLayout.LayoutParams ll = new LayoutParams(
                LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT);
        colorLayout.setBackgroundColor(Color.BLACK);
        colorLayout.setLayoutParams(ll);
        return colorLayout;
    }
}

之前，我们学习的Action Bar是标准模式，Tab模式的如下图所示。

对于Tab，我们在Android学习笔记（二二）： 多页显示-Tag的使用中学习过，但Action Bar的tab更适合fragment的使用。我们在之前实现的标准Action Bar的基础上添加导航用的tab，代码如下：

public class TabbedActionBarDemo extends SearchTestCase3 implements ActionBar.TabListener{
    @Override 
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState); 
        workWithTabbedActionBar(); 
    } 
    private void workWithTabbedActionBar(){ 
        ActionBar bar = getActionBar(); 
        bar.setTitle("Tabbed action bar"); //可以修改在AndroidManifest.xml中设定的action bar的title
        bar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS); //缺省为ActionBar.NAVIGATION_MODE_STANDARD，即标准模式。在标准模式下，是不呈现Tab出来的。 

        ActionTab.Tab tab1 = bar.newTab(); 
        tab1.setText("Tab1"); 
        tab1.setTabListener(this);  //如果我们忘了添加setTabListener()，在运行时会异常，设置null也不行。
        bar.addTab(tab1); 

       bar.addTab(bar.newTab() 
                           .setText("Tab2")  
                           .setTabListener(this)); 
    } 

    @Override //ActionBar.TabListener接口，在已选择的基础上，再次选择的回调函数
    public void onTabReselected(Tab tab, FragmentTransaction ft) { 
        showInfo(tab.getText() + " onTabReselected() is called");       
    } 

    @Override //ActionBar.TabListener接口，选择tab的回调函数。目前为Tab1，当用户选择tab2时，先触发tab1的onTabUnselected()，再触发tab2的onTableSelected()
    public void onTabSelected(Tab tab, FragmentTransaction ft) {
        showInfo(tab.getText() + " onTabSelected() is called");      
    } 

    @Override //ActionBar.TabListener接口，不再选择（选择其他）的回调函数
    public void onTabUnselected(Tab tab, FragmentTransaction ft) { 
        showInfo(tab.getText() + " onTabUnselected() is called");
    }  
        
}

ActionBar.Tab很适合用于fragment，在不同的fragment中切换，此时，具体实现ActionBar.TabListener的可能就是Fragment的继承类。