通常在ViewPager的上方,我们都会放一个标签指示器与ViewPager进行联动。以前,我们大多使用的是GitHub上的开源框架PagerSlidingTabTrip,具体的可以参见https://github.com/astuetz/PagerSlidingTabStrip。而现在,我们可以使用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的实例实现完毕了。就是这么简单,运行之后效果如下:
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上显示了图标,是不是想同时显示文本+图标了?有了上面显示图标的途径,是不是在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上显示自定义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
关于源码:
- 不只是本文涉及的代码,会包含很多知识点的代码,应该都会在我的简书中进行介绍。
- 有可能代码与本文中所贴出来的有差异,但应该都是我觉得更好的方式吧。
- 欢迎大家对我进行批评教育。
参考链接:
https://guides.codepath.com/android/google-play-style-tabs-using-tablayout#design-support-library