Develop程序android实用技术

TabLayout使用详解

2016-08-09  本文已影响50267人  DoAndKeep

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

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

TabLayout的基本使用

  1. 在应用的build.gradle中添加support:design支持库
compile "com.android.support:design:24.1.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使用详解》。

  2. 创建显示微博的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无关，有兴趣的可以看源码。

  3. 创建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()的返回值，则会用来作为标签的显示内容。

  4. 在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的实例实现完毕了。就是这么简单，运行之后效果如下：

简单的文本Tab

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即可。

下面是运行效果：

图标Tab

在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;
}

运行效果如下：

图标文本Tab

在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 && tabLayout.getSelectedTabPosition() != position
            && 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
                && 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的状态。对于源码感兴趣的，可以自行前往研究...

最后，附上源码地址：
https://github.com/FILWAndroid/DevJourney

关于源码：

  1. 不只是本文涉及的代码，会包含很多知识点的代码，应该都会在我的简书中进行介绍。
  2. 有可能代码与本文中所贴出来的有差异，但应该都是我觉得更好的方式吧。
  3. 欢迎大家对我进行批评教育。

参考链接：
https://guides.codepath.com/android/google-play-style-tabs-using-tablayout#design-support-library

上一篇下一篇

猜你喜欢

热点阅读