Android TabLayout使用详解

通常在ViewPager的上方,我们都会放一个标签指示器与ViewPager进行联动。以前,我们大多使用的是GitHub上的开源框架PagerSlidingTabTrip。而现在,我们可以使用Android自带的控件TabLayout来实现这个效果了,而且TabLayout更为强大,因为Tab标签可以使用自定义View。

本文通过TabLayout+ViewPager来展示新浪微博中的三种状态微博,分别是广场微博、好友微博以及我的微博。

TabLayout的基本使用
在应用的build.gradle中添加support:design支持库

compile "com.android.support:design:24.1.1"

创建activity_weibo_timeline.xml文件,在布局文件中添加TabLayout及ViewPager:

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

    <include
        layout="@layout/toolbar"/>

    <android.support.design.widget.TabLayout
        android:id="@+id/timeline_tablayout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

    <android.support.v4.view.ViewPager
        android:id="@+id/timeline_viewpager"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</LinearLayout>

布局中toolbar可以忽略,想了解关于Toolbar的知识,可以参见:《Toobar使用详解》。

创建显示微博的Fragment。

布局文件fragment_weibo_timelien.xml内容如下:

<?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.support.v7.widget.RecyclerView
              android:id="@+id/timeline_rv"
              android:layout_width="match_parent"
              android:layout_height="match_parent"/>

</RelativeLayout>

通过RecyclerView展示微博列表。

WeiboTimelineFragment.java内容如下:

public class WeiboTimelineFragment extends BaseFragment {

    private static final String ARG_TIMELINE_TYPE = "ARG_TIMELINE_TYPE";

    @BindView(R.id.timeline_content_tv)
    TextView mContentTV;

    private int mType;

    public static WeiboTimelineFragment newInstance(int type) {
        Bundle args = new Bundle();
        args.putInt(ARG_TIMELINE_TYPE, type);
        WeiboTimelineFragment fragment = new WeiboTimelineFragment();
        fragment.setArguments(args);
        return fragment;
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        mType = getArguments().getInt(ARG_TIMELINE_TYPE);
    }

    @Override
    protected int getLayoutResId() {
        return R.layout.fragment_weibo_timeline;
    }

    @Override
    protected void initView(View view, Bundle savedInstanceState) {
        // 展示微博逻辑
    }

}

Fragment根据传入的type,来展示不同类型的微博列表。WeiboTimelineFragment继承的BaseFragment主要根据子类getLayoutResId()返回值创建了Fragment的显示视图,绑定了ButterKnife。这部分有TabLayout无关,有兴趣的可以看源码。

创建ViewPager的适配器WeiboTimelineAdapter:

public class WeiboTimelineAdapter extends FragmentPagerAdapter {

    private static final int PAGE_COUNT = 3;

    private Context mContext;

    public WeiboTimelineAdapter(Context context, FragmentManager fm) {
        super(fm);
        this.mContext = context;
    }

    @Override
    public Fragment getItem(int position) {
        int type;
        switch (position) {
            case 0:
                type = Constants.TYPE_TIMELINE_PUBLIC;
                break;
            case 1:
                type = Constants.TYPE_TIMELINE_FRIEND;
                break;
            case 2:
                type = Constants.TYPE_TIMELINE_MINE;
                break;
            default:
                type = Constants.TYPE_TIMELINE_PUBLIC;
                break;
        }
        return WeiboTimelineFragment.newInstance(type);
    }

    @Override
    public int getCount() {
        return PAGE_COUNT;
    }

    @Override
    public CharSequence getPageTitle(int position) {
        switch (position) {
            case 0:
                return "广场";
            case 1:
                return "好友";
            case 2:
                return "我";
            default:
                return "微博";
        }
    }
}

其中,getItem()以及getCount()是必须实现的,分别返回每个page显示的Fragment和page的数量。而getPageTitle()的返回值,则会用来作为标签的显示内容。

在WeiboTimelineActivity中,将TabLayout、ViewPager以及Adapter关联起来。

public class WeiboTimelineActivity extends BaseActvity {

    @BindView(R.id.timeline_tablayout)
    TabLayout mTabLayout;
    @BindView(R.id.timeline_viewpager)
    ViewPager mViewPager;

    @Override
    protected int getContentViewId() {
        return R.layout.activity_weibo_timeline;
    }

    @Override
    protected String getToolbarTitle() {
        return "微博状态";
    }

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        mViewPager.setAdapter(new WeiboTimelineAdapter(mActvity, mActvity.getSupportFragmentManager()));
        mTabLayout.setupWithViewPager(mViewPager);
    }
}

BaseActivity与BaseFragment的作用大致相同。至此,最基本的TabLayout+ViewPager的实例实现完毕了。就是这么简单,运行之后效果如下:

image.png

TabLayout使用进阶
修改TabLayout的风格
上面我们创建的TabLayout的下面的标识线是粉色的,这个颜色采用的是应用的Meterial Design主题中的强调类型颜色。示例中的主题跟颜色如下:

<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <!-- Customize your theme here. -->
    <item name="colorPrimary">@color/colorPrimary</item>
    <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
    <item name="colorAccent">@color/colorAccent</item>
</style>
<color name="colorPrimary">#3F51B5</color>
<color name="colorPrimaryDark">#303F9F</color>
<color name="colorAccent">#FF4081</color>

很多情况,我们需要更改标示线的颜色,以及标题的颜色大小,整个TabLayout的背景颜色等等,实现的方式就是自定义我们的TabLayout Style:

<style name="MyCustomTabLayout" parent="Widget.Design.TabLayout">
    <item name="tabMaxWidth">@dimen/tab_max_width</item>
    <item name="tabIndicatorColor">?attr/colorAccent</item>
    <item name="tabIndicatorHeight">2dp</item>
    <item name="tabPaddingStart">12dp</item>
    <item name="tabPaddingEnd">12dp</item>
    <item name="tabBackground">?attr/selectableItemBackground</item>
    <item name="tabTextAppearance">@style/MyCustomTabTextAppearance</item>
    <item name="tabSelectedTextColor">?android:textColorPrimary</item>
</style>
<style name="MyCustomTabTextAppearance" parent="TextAppearance.Design.Tab">
    <item name="android:textSize">14sp</item>
    <item name="android:textColor">?android:textColorSecondary</item>
    <item name="textAllCaps">true</item>
</style>

可以看到,很多属性我们都可以更改,之后只要应用这个Style即可。

在Tab上显示图标
TabLayout没有明确地提供向Tab中设置图标的途径,但是很多事情总可以另辟蹊径。我们知道,Tab是使用adapter中的getPageTitle()方法做其显示的内容,这个方法返回类型为CharSequence。于是,我们可以创建一个SpannableString,而将图标放置在ImageSpan中,设置在SpannableString中:

public CharSequence getPageTitle(int position) {
    Drawable drawable;
    switch (position) {
        case 0:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_public);
            break;
        case 1:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_friend);
            break;
        case 2:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_mine);
            break;
        default:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_public);
            break;
    }
    drawable.setBounds(0, 0, drawable.getIntrinsicWidth(), drawable.getIntrinsicHeight());
    ImageSpan imageSpan = new ImageSpan(drawable, ImageSpan.ALIGN_BOTTOM);
    SpannableString spannableString = new SpannableString(" ");
    spannableString.setSpan(imageSpan, 0, 1, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

    return spannableString;
}

此时,设置完之后运行,发现Tab上并没有显示图标,而是什么也没有了。这是因为TabLayout的textAllCaps属性默认值是true,会阻止ImageSpan的渲染,我们只需要将其重写为false即可。

下面是运行效果:

image.png

在Tab上显示图文
上面我们成功地在Tab上显示了图标,是不是想同时显示文本+图标了?有了上面显示图标的途径,是不是在SpannableString中添加文本就可以了:

public CharSequence getPageTitle(int position) {
    Drawable drawable;
    String title;
    switch (position) {
        case 0:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_public);
            title = "广场";
            break;
        case 1:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_friend);
            title = "好友";
            break;
        case 2:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_mine);
            title = "我";
            break;
        default:
            drawable = ContextCompat.getDrawable(mContext, R.drawable.icon_weibo_timeline_public);
            title = "微博";
            break;
    }
    drawable.setBounds(0, 0, drawable.getIntrinsicWidth(), drawable.getIntrinsicHeight());
    ImageSpan imageSpan = new ImageSpan(drawable, ImageSpan.ALIGN_BOTTOM);
    SpannableString spannableString = new SpannableString(" " + title);
    spannableString.setSpan(imageSpan, 0, 1, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);

    return spannableString;
}

运行效果如下:

image.png

在Tab上显示自定义View
无论是显示文本、图标,亦或者图文,并不能保证可以满足我们的需求、我们的野心。只有能在Tab上显示任何我们想显示的内容,才能打动我们,从而感叹“好的,就用你来显示Tab了!”。可喜可贺的是,TabLayout中的Tab是支持设置自定义View的。

首先,先定义我们Tab上显示的View布局view_weibo_timeline_tab.xml:

<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ImageView
        android:id="@+id/timeline_tab_icon_iv"
        android:layout_width="32dp"
        android:layout_height="32dp"
        android:layout_centerHorizontal="true"/>

</RelativeLayout>

这里为了介绍,就简单的显示个图标了。紧接着,编写对应的TimelineTabView.java:

public class TimelineTabView extends FrameLayout {

    @BindView(R.id.timeline_tab_icon_iv)
    ImageView mIconIV;

    public TimelineTabView(Context context) {
        super(context);
        init(context);
    }

    public TimelineTabView(Context context, AttributeSet attrs) {
        super(context, attrs);
        init(context);
    }

    private void init(Context context) {
        View.inflate(context, R.layout.view_weibo_timeline_tab, this);
        ButterKnife.bind(this, this);
    }

    public void setData(int iconResId) {
        mIconIV.setImageResource(iconResId);
    }
}

很简单,对外提供一个设置图标的方法。有了自定义View,只需要设置到TabLayout中的每个Tab上即可。在WeiboTimelineActivity.java的onCreate()方法中进行设置:

protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    mTimelineAdapter = new WeiboTimelineAdapter(mActvity, mActvity.getSupportFragmentManager());

    mViewPager.setAdapter(mTimelineAdapter);
    mTabLayout.setupWithViewPager(mViewPager);

    for (int i = 0; i < mTabLayout.getTabCount(); i++) {
        mTabLayout.getTabAt(i).setCustomView(mTimelineAdapter.getTabView(i));
    }

}

OK,此时TabLayout上的Tab就会显示我们自定义的View视图了,因为只是设置了个图标,运行效果与在Tab上显示图标一样。

TabLayout源码分析
上面我们使用了自定义View作为Tab,但是有个问题上没有处理,就是Tab在选中时候的高亮状态。如果使用文本Tab,我们可以设置Style中的tabSelectedTextColor来实现,那么想一想TabLayout是在什么时机使用这个资源值的?我们是否也可以在此时机改变自定义View的显示来标记选中。

用过PagerSlidingTabTrip的同学可能知道,其原理是引用了ViewPager的OnPageChangeListener来进行联动的,使用的是viewpager.setOnPageChangeListener(),从而使得在你应用中如果想监听ViewPager的页面状态改变,需要使用PagerSlidingTabTrip的setOnPageChangeListener(),也就是说PagerSlidingTabTrip占用了ViewPager的页面状态监听。

TabLayout与ViewPager联动也肯定得监听ViewPager的页面改变,查看关联ViewPager与TabLayout的内部实现,即TabLayout的setupWithViewPager()方法:

private void setupWithViewPager(@Nullable final ViewPager viewPager, boolean autoRefresh,
            boolean implicitSetup) {
    ...
    // Add our custom OnPageChangeListener to the ViewPager
    if (mPageChangeListener == null) {
        mPageChangeListener = new TabLayoutOnPageChangeListener(this);
    }
    mPageChangeListener.reset();
    viewPager.addOnPageChangeListener(mPageChangeListener);
    ...
}

可以看到,给ViewPager添加,注意是添加而不是设置,说明现在ViewPager可以添加任意个页面改变监听器了。与PagerSlidingTabTrip的设置方式相比较,这种方式更好了,看来代码与时俱进还是很重要的,使用TabLayout还是值得的。

好了,放弃题外话,继续关注TabLayoutOnPageChangeListener的实现,关注onPageSelected()方法:

@Override
public void onPageSelected(final int position) {
    final TabLayout tabLayout = mTabLayoutRef.get();
    if (tabLayout != null &amp;&amp; tabLayout.getSelectedTabPosition() != position
            &amp;&amp; position < tabLayout.getTabCount()) {
        // Select the tab, only updating the indicator if we're not being dragged/settled
        // (since onPageScrolled will handle that).
        final boolean updateIndicator = mScrollState == SCROLL_STATE_IDLE
                || (mScrollState == SCROLL_STATE_SETTLING
                &amp;&amp; mPreviousScrollState == SCROLL_STATE_IDLE);
        tabLayout.selectTab(tabLayout.getTabAt(position), updateIndicator);
    }
}

当ViewPager的页面改变时会调用selectTab()方法:

void selectTab(final Tab tab, boolean updateIndicator) {
    final Tab currentTab = mSelectedTab;

    if (currentTab == tab) {
        ...
    } else {
        ...        
        if (newPosition != Tab.INVALID_POSITION) {
            setSelectedTabView(newPosition);
        }
        ...
    }
}

当新的选中Tab与当前不同时,调用了setSelectedTabView()方法:

private void setSelectedTabView(int position) {
    final int tabCount = mTabStrip.getChildCount();
    if (position < tabCount) {
        for (int i = 0; i < tabCount; i++) {
            final View child = mTabStrip.getChildAt(i);
            child.setSelected(i == position);
        }
    }
}

最后,重新设置了每个TabView的选中状态。也就说,当选中某个Tab时,我们对应的自定义View的setSelected()方法就会调用。所以,当需要根据Tab是否选中更新自定义View的状态时,可以重写setSelected()方法:

@Override
public void setSelected(boolean selected) {
    super.setSelected(selected);
    // 更改文本颜色、图标、背景等等
}

好了,分析完毕,原谅我这个标题党,我只想简单分析如何根据Tab是否选中更新自定义View的状态。对于源码感兴趣的,可以自行前往研究...

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,076评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,658评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,732评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,493评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,591评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,598评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,601评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,348评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,797评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,114评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,278评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,953评论 5 339
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,585评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,202评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,442评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,180评论 2 367
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,139评论 2 352

推荐阅读更多精彩内容