一行代码实现底部导航栏TabLayout

app中底部导航栏已经是很常见的控件了,比如微信,,QQ等都有这类控件,都是点击底部标签切换界面。主要的实现手段有

  • RadioGroup
  • FragmentTabLayout
  • TabLayout
  • Bottom Navigation

其中TabLayout一般作为顶部的导航栏使用,今天我们基于FragmentTabLayout来实现一个底部导航栏。先看下实现的效果:


一行代码实现底部导航栏TabLayout_第1张图片
1.png

一行代码实现底部导航栏TabLayout_第2张图片
2.png

今天这个探索会按照下面这个步骤:

  • FrameTabLayout布局
  • 自定义控件
  • 接口封装
  • 一行代码使用
  • FrameTabLayout源码分析

好了,准备开车~~~

1.FrameTabLayout布局

为什么要提下这个布局,其实这个系统自带的布局比较特殊,要使用系统的id,也就是我们不能自己命名android:id,我们对着具体的布局实现R.layout.myfragment_tab_layout看比较容易明白。
布局其实比较简单,有几个点需要注意下的

id是android:id/tabcontent的FrameLayout明显就是放置内容的,我们的栗子中就是放置Fragment,这个id就是用的系统的不能做更改

id是android:id/tabs的TabWidget顾名思义就是放置底部标签的,就是上图中的Home,Contact等等balabala,对的,你猜到了,这个id也是不能改

为了区分,我故意用了两种高调的颜色作为区分,上图中绿色的区域就是FrameLayout, 橙色的区域就是TabWidget


    
        
        
    

具体为什么id不能改,后面我们分析源码的时候就知道了,先按下,客官继续往后看~~~

2.自定义控件MyFragmentTabLayout

这里为了方便我们直接继承自FragmentTabHost,也没有自定义属性(请原谅我偷懒),上来就是加载上面贴出来的布局, dividerDrawable就是用来设置底部标签栏标签之间分割线用途。

private void init(){
        View view = LayoutInflater.from(getContext()).inflate(R.layout.myfragment_tab_layout, this, true);

        fragmentTabHost = (FragmentTabHost) view.findViewById(android.R.id.tabhost);

        dividerDrawable = null;
}

在继续往下说之前,我们先看下如果不自定义这个控件,我们是怎么使用FragmentTabHost的,我下面贴出的是示意代码,不能直接使用的,不过也可以看出来比较繁琐,也直接证明了封装的必要性。

fragmentTabHost.setup(getContext(), fragmentManager, android.R.id.tabcontent);
TabSpec tabSpec = fragmentTabHost.newTabSpec(……);
fragmentTabHost.addTab(tabSpec, fragment.class, bundle);
fragmentTabHost.getTabWidget().setDividerDrawable(……);

我们对着上面的示意过程来接着看下自定义MyFragmentTabLayout控件剩下的过程。这个方法其实就是调用setup,方法的原型是setup(Context context, FragmentManager manager, int containerId)第一个context没什么好说的,需要外界传入fragmentManager,用来管理fragment,containerId就是用来放置内容的控件id,就是我们上面绿色背景的FrameLayout。

public MyFragmentTabLayout init(FragmentManager fragmentManager) {
        fragmentTabHost.setup(getContext(), fragmentManager, android.R.id.tabcontent);
        return this;
}

经过上面的过程fragmentTabHost的初始化过程就结束了。有些小伙伴就急了,底部标签栏还没见踪影呢???别急,听我娓娓道来(逃),底部标签栏的个数肯定是不能写死的,最好是根据数据的数量来做决定,google就是这么做的,因此标签的初始化是要在fragmentTabHost的数据初始化过程中进行。具体实现代码往下看。

  • fragmentTabHost.newTabSpec这个方法就是用来构造底部标签栏,需要传入一个Tag,和一个tabview,我们这里很简单就是上面图片下面文字的布局
  • fragmentTabHost.addTab就是构造内容区域(fragment)和底部标签栏,有需要传递给fragment的数据可以通过bundle传送
  • setDividerDrawable我们这里传入null,就是不需要分割线,默认是有分割线:
3.png
  • setOnTabChangedListener就是设置标签的点击事件
public MyFragmentTabLayout creat(){
        if (fragmentTabLayoutAdapter == null) return null;
        TabInfo tabInfo;
        for (int i = 0; i < fragmentTabLayoutAdapter.getCount(); i++){
            tabInfo = fragmentTabLayoutAdapter.getTabInfo(i);
            TabSpec tabSpec = fragmentTabHost.newTabSpec(tabInfo.getTabTag()).setIndicator(tabInfo.getTabView());
            fragmentTabHost.addTab(tabSpec, tabInfo.getFragmentClass(), tabInfo.getBundle());
            fragmentTabHost.getTabWidget().setDividerDrawable(dividerDrawable);
            fragmentTabHost.setOnTabChangedListener(new OnTabChangeListener() {
                @Override
                public void onTabChanged(String tabId) {
                    int currentTab = fragmentTabHost.getCurrentTab();
                    fragmentTabLayoutAdapter.onClick(currentTab);
                }
            });
        }
        return this;
}

底部标签布局:



    
    

上面代码是经过接口封装的,我们接着往下看

3.接口封装

我们也是在控件中留出来一个接口做hook,用户可以通过接口给控件定制数据,定制标签布局,定制点击事件

public interface FragmentTabLayoutAdapter{

        int getCount();

        TabInfo getTabInfo(int pos);

        View createView(int pos);

        void onClick(int pos);

}

我们再回顾下上面自定义的过程,标签的个数通过getCount得到;构造每个标签需要的数据都从getTabInfo获得,参数pos就是标签的位置;每个标签的布局则通过createView获得,参数pos同上;onClick就是标签的点击事件,参数pos同上。

4.一行代码使用

到这里自定义导航栏的工作就差不多了,我们看下具体怎么用,首先就是在布局文件中声明控件,这个布局文件很简单就是引用我们自定义的控件,没什么好解释的。



    


接下来在代码中用一行代码实现即可,传入fragmentManager进行初始化,然后就是传入接口FragmentTabLayoutAdapter的实现,我们这里也进行了抽取,提供一个默认的实现,用户只需要实现createView 定制自己需要显示的布局和实现onClick定制每个标签的点击事件,我们这里为了简化只是通过一个Toast进行演示。

fragmentTabHost.init(getSupportFragmentManager())
               .setFragmentTabLayoutAdapter(new DefaultFragmentTabAdapter(Arrays.asList(fragmentClass), Arrays.asList(textViewArray), Arrays.asList(drawables)){
                   @Override
                   public View createView(int pos) {
                       View view = LayoutInflater.from(MainActivity.this).inflate(R.layout.tab_item, null);
                       ImageView imageView = (ImageView) view.findViewById(R.id.img);
                       imageView.setImageResource(drawables[pos]);
                       TextView textView = (TextView) view.findViewById(R.id.tab_text);
                       textView.setText(textViewArray[pos]);
                       return view;
                   }

                   @Override
                   public void onClick(int pos) {
                       Toast.makeText(MainActivity.this, textViewArray[pos] + " be clicked", Toast.LENGTH_SHORT).show();
                   }
               }).creat();

是不是说话算话,一行代码搞定。我们看下DefaultFragmentTabAdapter的实现,默认实现了两个方法getCount和getTabInfo,第一个方法地球人都知道,第二个方法就是构造每个标签需要数据信息。

public class DefaultFragmentTabAdapter implements MyFragmentTabLayout.FragmentTabLayoutAdapter {

    private List fragmentclass = new ArrayList<>();
    private List fragmentTag = new ArrayList<>();
    private List drawables = new ArrayList<>();

    public DefaultFragmentTabAdapter(List fragmentclass, List fragmentTag, List drawables) {
        this.fragmentclass = fragmentclass;
        this.fragmentTag = fragmentTag;
        this.drawables = drawables;
    }

    @Override
    public int getCount() {
        return fragmentTag.size();
    }

    @Override
    public TabInfo getTabInfo(int pos) {
        return new TabInfo.Builder(fragmentTag.get(pos), createView(pos), fragmentclass.get(pos)).build();
    }

    @Override
    public View createView(int pos) {
        return null;
    }

    @Override
    public void onClick(int pos) {

    }
}

稍微提下TabInfo这个数据类,从上面可以看出也是build模式,这里就不多做介绍。几个属性,tabTag就是TabSpec需要传入的Tag;tabView就是底部标签的布局;fragmentClass就是每个标签对应的fragment;bundle是fragment对应的数据;backgroundRes就是每个标签的背景,可以设置点击时的背景变化。

public class TabInfo {

    String tabTag;

    View tabView;

    Class fragmentClass;

    Bundle bundle;

    int backgroundRes;

    ……
}

5.FrameTabLayout源码分析

我们接着简单看下FrameTabLayout的源码,首先就是初始化时见到的setup方法,主要工作在ensureHierarchy方法中,我们接着跟。

public void setup(Context context, FragmentManager manager, int containerId) {
        ensureHierarchy(context);  // Ensure views required by super.setup()
        super.setup();
        mContext = context;
        mFragmentManager = manager;
        mContainerId = containerId;
        ensureContent();
        mRealTabContent.setId(containerId);

        // We must have an ID to be able to save/restore our state.  If
        // the owner hasn't set one at this point, we will set it ourselves.
        if (getId() == View.NO_ID) {
            setId(android.R.id.tabhost);
        }
}

这个方法是跟布局比较密切相关的,也能解释我们前面说的布局id写死的问题。如果没有找到id是android.R.id.tabs的TabWidget,系统会为我们生成一个布局,其中TabWidget就是底部标签栏,id是android.R.id.tabs和我们上面布局代码中一样的;mRealTabContent就是放置内容区域,是一个FrameLayout布局,id是 android.R.id.tabcontent,和我们上面布局代码FrameLayout是一样的。

private void ensureHierarchy(Context context) {
        // If owner hasn't made its own view hierarchy, then as a convenience
        // we will construct a standard one here.
        if (findViewById(android.R.id.tabs) == null) {
            LinearLayout ll = new LinearLayout(context);
            ll.setOrientation(LinearLayout.VERTICAL);
            addView(ll, new FrameLayout.LayoutParams(
                    ViewGroup.LayoutParams.MATCH_PARENT,
                    ViewGroup.LayoutParams.MATCH_PARENT));

            TabWidget tw = new TabWidget(context);
            tw.setId(android.R.id.tabs);
            tw.setOrientation(TabWidget.HORIZONTAL);
            ll.addView(tw, new LinearLayout.LayoutParams(
                    ViewGroup.LayoutParams.MATCH_PARENT,
                    ViewGroup.LayoutParams.WRAP_CONTENT, 0));

            FrameLayout fl = new FrameLayout(context);
            fl.setId(android.R.id.tabcontent);
            ll.addView(fl, new LinearLayout.LayoutParams(0, 0, 0));

            mRealTabContent = fl = new FrameLayout(context);
            mRealTabContent.setId(mContainerId);
            ll.addView(fl, new LinearLayout.LayoutParams(
                    LinearLayout.LayoutParams.MATCH_PARENT, 0, 1));
        }
 }

我们往下看addTab方法,这个方法就是绑定布局和数据。根据传入的TabSpec构造TabInfo,然后调用TabHost中的addTab(tabSepc) 方法。

public void addTab(@NonNull TabHost.TabSpec tabSpec, @NonNull Class clss,
            @Nullable Bundle args) {
        tabSpec.setContent(new DummyTabFactory(mContext));

        final String tag = tabSpec.getTag();
        final TabInfo info = new TabInfo(tag, clss, args);

        if (mAttached) {
            // If we are already attached to the window, then check to make
            // sure this tab's fragment is inactive if it exists.  This shouldn't
            // normally happen.
            info.fragment = mFragmentManager.findFragmentByTag(tag);
            if (info.fragment != null && !info.fragment.isDetached()) {
                final FragmentTransaction ft = mFragmentManager.beginTransaction();
                ft.detach(info.fragment);
                ft.commit();
            }
        }

        mTabs.add(info);
        addTab(tabSpec);
}

在addTab(tabSepc) 方法中mTabWidget.addView(tabIndicator)就是添加底部标签,那么Fragment呢?猜下应该是在setCurrentTab(0)进行添加,我们往下看。

public void addTab(TabSpec tabSpec) {
        ……

        mTabWidget.addView(tabIndicator);
        mTabSpecs.add(tabSpec);

        if (mCurrentTab == -1) {
            setCurrentTab(0);
        }
    }

在setCurrentTab方法中会调用invokeOnTabChangeListener()方法,最后调用onTabChanged方法,FragmentTabHost是实现了OnTabChangeListener接口,我们再回到FragmentTabHost往下看

private void invokeOnTabChangeListener() {
        if (mOnTabChangeListener != null) {
            mOnTabChangeListener.onTabChanged(getCurrentTabTag());
        }
}

/**
   * Interface definition for a callback to be invoked when tab changed
   */
public interface OnTabChangeListener {
        void onTabChanged(String tabId);
}

先调用doTabChanged,然后会处理我们定义的点击事件,我们往下看doTabChanged方法。如果存在fragment就直接attach,否则先Fragment.instantiate构造Fragment,然后通过add方法进行添加。看到这里整个流程也就清楚了。

public void onTabChanged(String tabId) {
        if (mAttached) {
            final FragmentTransaction ft = doTabChanged(tabId, null);
            if (ft != null) {
                ft.commit();
            }
        }
        if (mOnTabChangeListener != null) {
            mOnTabChangeListener.onTabChanged(tabId);
        }
}

private FragmentTransaction doTabChanged(@Nullable String tag,
            @Nullable FragmentTransaction ft) {
        final TabInfo newTab = getTabInfoForTag(tag);
        if (mLastTab != newTab) {
            if (ft == null) {
                ft = mFragmentManager.beginTransaction();
            }

            if (mLastTab != null) {
                if (mLastTab.fragment != null) {
                    ft.detach(mLastTab.fragment);
                }
            }

            if (newTab != null) {
                if (newTab.fragment == null) {
                    newTab.fragment = Fragment.instantiate(mContext,
                            newTab.clss.getName(), newTab.args);
                    ft.add(mContainerId, newTab.fragment, newTab.tag);
                } else {
                    ft.attach(newTab.fragment);
                }
            }

            mLastTab = newTab;
}      

6.总结

如果你能看到这里,说明是真爱。使用FragmentTabHost需要注意的就是布局的时候几个id的问题,更简单的办法就是使用我封装的控件,就没什么需要注意的了:)

代码放到网上,有需要的自行下载,别忘了点赞哦。
GitHub地址

今天的自定义FragmentTabLayout之旅就到这里结束了,大家可以下车了,你们的赞是我最大的动力,谢谢!

欢迎关注公众号:JueCode

你可能感兴趣的:(一行代码实现底部导航栏TabLayout)