美文网首页Android 开源库Android知识Android开发
一行代码实现底部导航栏TabLayout

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

作者: juexingzhe | 来源:发表于2017-06-25 00:57 被阅读2496次

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

    • RadioGroup
    • FragmentTabLayout
    • TabLayout
    • Bottom Navigation

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


    1.png
    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

    <android.support.v4.app.FragmentTabHost xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:id="@android:id/tabhost"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        tools:context="com.example.juexingzhe.testfragmenttablayout.MainActivity">
        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:orientation="vertical">
            <FrameLayout
                android:id="@android:id/tabcontent"
                android:layout_width="match_parent"
                android:layout_height="0dp"
                android:layout_weight="1"
                android:background="@android:color/holo_green_dark" />
            <TabWidget
                android:id="@android:id/tabs"
                android:layout_width="match_parent"
                android:layout_height="?attr/actionBarSize"
                android:layout_gravity="bottom"
                android:background="@android:color/holo_orange_dark" />
        </LinearLayout>
    </android.support.v4.app.FragmentTabHost>
    

    具体为什么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;
    }
    

    底部标签布局:

    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:gravity="center">
    
        <ImageView
            android:id="@+id/img"
            android:layout_width="match_parent"
            android:layout_height="wrap_content" />
        <TextView
            android:gravity="center"
            android:id="@+id/tab_text"
            android:layout_width="match_parent"
            android:layout_height="wrap_content" />
    </LinearLayout>
    

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

    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.一行代码使用

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

    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context="com.example.juexingzhe.testfragmenttablayout.MainActivity"
        android:orientation="vertical">
    
        <com.example.juexingzhe.testfragmenttablayout.MyFragmentTabLayout
            android:id="@+id/tab_layout"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>
    
    </LinearLayout>
    

    接下来在代码中用一行代码实现即可,传入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<Class> fragmentclass = new ArrayList<>();
        private List<String> fragmentTag = new ArrayList<>();
        private List<Integer> drawables = new ArrayList<>();
    
        public DefaultFragmentTabAdapter(List<Class> fragmentclass, List<String> fragmentTag, List<Integer> 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

    相关文章

      网友评论

      • 刘sir_418e:你好,我想对底部进行未读消息的提示怎么处理 含小数点 和数字的提示
      • 秦子帅:不错,相互关注吧?

      本文标题:一行代码实现底部导航栏TabLayout

      本文链接:https://www.haomeiwen.com/subject/uzqlcxtx.html