簡介
PagerSlidingTabStrip，是我個人經常使用到的一個和ViewPager配合的頁面指示器，可以滿足開發過程中常用的需求，如類似于今日頭條的首頁新聞內容導航欄等等，之前自己開發的JuheNews和正在開發的GankIOClient均有使用到它，所以想對其進行一個全面的介紹。
JuheNews
GankIOClient
PagerSlidingTabStrip源碼地址：https://github.com/astuetz/PagerSlidingTabStrip
簡單使用
- 添加庫依賴
dependencies {compile 'com.astuetz:pagerslidingtabstrip:1.0.1'}
- 定義布局文件
<com.astuetz.PagerSlidingTabStrip
android:id="@+id/psts_indicator"
android:layout_width="match_parent"
android:layout_height="40dp"/>
<android.support.v4.view.ViewPager
android:id="@+id/vp_content"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
- 關聯ViewPager
public class MainActivity extends AppCompatActivity {
@BindView(R.id.psts_indicator)
PagerSlidingTabStrip pstsIndicator;
@BindView(R.id.activity_main)
LinearLayout activityMain;
@BindView(R.id.vp_content)
ViewPager vpContent;
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ButterKnife.bind(this);
MainPagerAdapter mainPagerAdapter = new MainPagerAdapter(getSupportFragmentManager());
vpContent.setAdapter(mainPagerAdapter);
pstsIndicator.setViewPager(vpContent);
}
}
-
結果
這里寫圖片描述 - 后話
看到這個效果，是不是很炸裂，如此的丑陋，上圖是什么屬性都沒有修改默認的效果圖，接著我們看下源碼，看下可以從哪方面來進行改造。
源碼解析
這個開源庫，簡單點說就是大家都非常熟悉的自定義View，所以，解讀的方式可以從自定義屬性到此視圖的構造，onMeasure,onLayout, onDraw等等
- 自定義的屬性值
<?xml version="1.0" encoding="utf-8"?>
<resources>
<declare-styleable name="PagerSlidingTabStrip">
<!--底部滑動指示器的顏色-->
<attr name="pstsIndicatorColor" format="color" />
<!--底部用于給指示器滑動的區域的顏色-->
<attr name="pstsUnderlineColor" format="color" />
<!--分割線的顏色-->
<attr name="pstsDividerColor" format="color" />
<!--指示器的高度-->
<attr name="pstsIndicatorHeight" format="dimension" />
<!--底部區域的高度-->
<attr name="pstsUnderlineHeight" format="dimension" />
<!--分割線與上下的間距-->
<attr name="pstsDividerPadding" format="dimension" />
<!--每個Tab的左右邊距-->
<attr name="pstsTabPaddingLeftRight" format="dimension" />
<!--選中tab的滾動偏移量,個人基本沒有用到過-->
<attr name="pstsScrollOffset" format="dimension" />
<!--每個Tab的背景圖，StateListDrawable-->
<attr name="pstsTabBackground" format="reference" />
<!--是否根據tab均為位置，true的時候均分，默認為false,一般都是使用默認值-->
<attr name="pstsShouldExpand" format="boolean" />
<!--標題文本是否大寫，默認為true-->
<attr name="pstsTextAllCaps" format="boolean" />
</declare-styleable>
</resources>
看下大致的布局和屬性對號入座
屬性對應圖
- PagerSlidingTabStrip.java類結構
getter and setter
類中的getter和setter方法，基本上和上面的自定義屬性可以對上號，不僅可以在布局文件中定義，還可以通過java代碼進行設置。
變量
類中使用到的變量，大部分都是和自定義屬性掛鉤的，主要關注幾個
- ATTRS : 引用Android系統的兩個屬性，文本字體大小和字體顏色
- pageListener：內部使用的OnPagerChangeListener,通過setViewPager實現和ViewPager的聯動
- delegatePageListener ：暴露給開發者的接口，類本身使用到了兩個OnPageChangeListener，一個用來實現自己的邏輯，而這個則是留給開發者實現自己需要針對ViewPager的頁面變化的邏輯||tabsContainer|內部容器，用戶所見文本指示器和圖標指示器的父節點，所以，如果需要針對文本指示器或者是圖標指示器做什么操作，通過這個查找孩子節點即可
關鍵方法
IconTabProvider
類中比較關鍵的一些內容，接口IconTabProvider，ViewPager對應的Adapter實現該方法并返回每個ViewPager對應的圖標即可實現圖標指示器。PageListener <用戶自定義的OnPagerListener的事件處理集成于此處>
private class PageListener implements OnPageChangeListener {
@Override
public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
//存儲當前位置信息
currentPosition = position;
currentPositionOffset = positionOffset;
//滑動到子視圖
scrollToChild(position, (int) (positionOffset * tabsContainer.getChildAt(position).getWidth()));
invalidate();//觸發重繪
//用戶自定義的OnPagerChangeListener事件之onPagerScrolled
if (delegatePageListener != null) {
delegatePageListener.onPageScrolled(position, positionOffset, positionOffsetPixels);
}
}
@Override
public void onPageScrollStateChanged(int state) {
//已經滑動完成，offset歸0
if (state == ViewPager.SCROLL_STATE_IDLE) {
scrollToChild(pager.getCurrentItem(), 0);
}
//用戶自定義的OnPagerChangeListener事件之onPageScrollStateChanged
if (delegatePageListener != null) {
delegatePageListener.onPageScrollStateChanged(state);
}
}
@Override
public void onPageSelected(int position) {
//這里類內部沒有做什么處理，只處理用戶自定義的OnPagerSelected方法
if (delegatePageListener != null) {
delegatePageListener.onPageSelected(position);
}
}
}
/**
*滑動指定子視圖
*/
private void scrollToChild(int position, int offset) {
if (tabCount == 0) {
return;
}
int newScrollX = tabsContainer.getChildAt(position).getLeft() + offset;if (position > 0 || offset > 0) {
newScrollX -= scrollOffset;
}
if (newScrollX != lastScrollX) {
lastScrollX = newScrollX;
scrollTo(newScrollX, 0);
}
}
- PagerSlidingTabStrip構造方法
構造方法的內容不多，基本上全是基本屬性的獲取，自定義View中常用的TypedArray ，記得回收recycle()，這里關注一下TypedValue.applyDimension方法的使用，全部轉換成px。
public PagerSlidingTabStrip(Context context, AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
setFillViewport(true);
setWillNotDraw(false);
tabsContainer = new LinearLayout(context);
tabsContainer.setOrientation(LinearLayout.HORIZONTAL);
tabsContainer.setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
addView(tabsContainer);
DisplayMetrics dm = getResources().getDisplayMetrics();
scrollOffset = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, scrollOffset, dm);
indicatorHeight = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, indicatorHeight, dm);
underlineHeight = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, underlineHeight, dm);
dividerPadding = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, dividerPadding, dm);
tabPadding = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, tabPadding, dm);
dividerWidth = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, dividerWidth, dm);
tabTextSize = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_SP, tabTextSize, dm);
// get system attrs (android:textSize and android:textColor)
TypedArray a = context.obtainStyledAttributes(attrs, ATTRS);
tabTextSize = a.getDimensionPixelSize(0, tabTextSize);
tabTextColor = a.getColor(1, tabTextColor);a.recycle();
// get custom attrs
a = context.obtainStyledAttributes(attrs, R.styleable.PagerSlidingTabStrip);
indicatorColor = a.getColor(R.styleable.PagerSlidingTabStrip_pstsIndicatorColor, indicatorColor);
underlineColor = a.getColor(R.styleable.PagerSlidingTabStrip_pstsUnderlineColor, underlineColor);
dividerColor = a.getColor(R.styleable.PagerSlidingTabStrip_pstsDividerColor, dividerColor);
indicatorHeight = a.getDimensionPixelSize(R.styleable.PagerSlidingTabStrip_pstsIndicatorHeight, indicatorHeight);
underlineHeight = a.getDimensionPixelSize(R.styleable.PagerSlidingTabStrip_pstsUnderlineHeight, underlineHeight);
dividerPadding = a.getDimensionPixelSize(R.styleable.PagerSlidingTabStrip_pstsDividerPadding, dividerPadding);
tabPadding = a.getDimensionPixelSize(R.styleable.PagerSlidingTabStrip_pstsTabPaddingLeftRight, tabPadding);
tabBackgroundResId = a.getResourceId(R.styleable.PagerSlidingTabStrip_pstsTabBackground, tabBackgroundResId);
shouldExpand = a.getBoolean(R.styleable.PagerSlidingTabStrip_pstsShouldExpand, shouldExpand);
scrollOffset = a.getDimensionPixelSize(R.styleable.PagerSlidingTabStrip_pstsScrollOffset, scrollOffset);
textAllCaps = a.getBoolean(R.styleable.PagerSlidingTabStrip_pstsTextAllCaps, textAllCaps);
a.recycle();
/* 初始化矩形Paint */
rectPaint = new Paint();
rectPaint.setAntiAlias(true);
rectPaint.setStyle(Style.FILL);
/* 初始化分割線Paint */
dividerPaint = new Paint();
dividerPaint.setAntiAlias(true);
dividerPaint.setStrokeWidth(dividerWidth);
/* 是否延伸，默認WRAP_CONTENT,這種比較合理 */
defaultTabLayoutParams = new LinearLayout.LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.MATCH_PARENT);
expandedTabLayoutParams = new LinearLayout.LayoutParams(0, LayoutParams.MATCH_PARENT, 1.0f);
if (locale == null) {
locale = getResources().getConfiguration().locale;
}
}
- onDraw
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
if (isInEditMode() || tabCount == 0) {
return;
}
final int height = getHeight();
// 設置Indicator顏色
rectPaint.setColor(indicatorColor);
// 獲取當前選中TabView
currentTab = tabsContainer.getChildAt(currentPosition);
//獲取Left,Right值
float lineLeft = currentTab.getLeft();
float lineRight = currentTab.getRight();
// if there is an offset, start interpolating left and right coordinates between current and next tab
if (currentPositionOffset > 0f && currentPosition < tabCount - 1) {
//結合下一個Tab獲取當前要繪制的indicator的位置,這里的currentPositionOffset 比較關鍵，可以看到這個值是與ViewPager相關的，在onPagerScrolled方法中，這個值在不斷的更新
View nextTab = tabsContainer.getChildAt(currentPosition + 1);
final float nextTabLeft = nextTab.getLeft();
final float nextTabRight = nextTab.getRight();
lineLeft = (currentPositionOffset * nextTabLeft + (1f - currentPositionOffset) * lineLeft);
lineRight = (currentPositionOffset * nextTabRight + (1f - currentPositionOffset) * lineRight);}
// 繪制Indicator
canvas.drawRect(lineLeft, height - indicatorHeight, lineRight, height, rectPaint);
// 繪制UnderLine
rectPaint.setColor(underlineColor);
canvas.drawRect(0, height - underlineHeight, tabsContainer.getWidth(), height, rectPaint);
// 繪制分割線
dividerPaint.setColor(dividerColor);
for (int i = 0; i < tabCount - 1; i++) {
View tab = tabsContainer.getChildAt(i);
canvas.drawLine(tab.getRight(), dividerPadding, tab.getRight(), height - dividerPadding, dividerPaint);
}
}
- setViewPager， setOnPageChangeListener
一個用來與ViewPager聯動，一個用來處理自定義的OnPagerListener邏輯
public void setViewPager(ViewPager pager) {
this.pager = pager;
if (pager.getAdapter() == null) {
throw new IllegalStateException("ViewPager does not have adapter instance.");
}
pager.setOnPageChangeListener(pageListener);notifyDataSetChanged();
}
public void setOnPageChangeListener(OnPageChangeListener listener) {
this.delegatePageListener = listener;
}
3.PagerSlidingTabStrip綜合用法
-
文本指示器選中后文本大小和顏色變化
實現的效果
關鍵點在于實現自己的OnPagerListener
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ButterKnife.bind(this);
MainPagerAdapter mainPagerAdapter = new MainPagerAdapter(getSupportFragmentManager());
vpContent.setAdapter(mainPagerAdapter);
pstsIndicator.setViewPager(vpContent);
vpContent.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
@Overridepublic void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
}
@Overridepublic void onPageSelected(int position) {
updateTextStyle(position);
}
@Overridepublic void onPageScrollStateChanged(int state) {
}
});
updateTextStyle(vpContent.getCurrentItem());
}
private void updateTextStyle(int position) {
LinearLayout tabsContainer = (LinearLayout) pstsIndicator.getChildAt(0);
for(int i=0; i< tabsContainer.getChildCount(); i++) {
TextView textView = (TextView) tabsContainer.getChildAt(i);
if(position == i) {
textView.setTextSize(18);
textView.setTextColor(getResources().getColor(R.color.colorToolbar));
} else {
textView.setTextSize(12);
textView.setTextColor(getResources().getColor(R.color.colorBlack));
}
}
}
-
圖標指示器選中圖標顏色變化
這里寫圖片描述
關鍵點在于實現自己的OnPagerListener和繼承PagerSlidingTabStrip.IconTabProvider
private void updateIconStyle(int position) {
LinearLayout tabsContainer = (LinearLayout) pstsIndicator.getChildAt(0);
for (int i = 0; i < tabsContainer.getChildCount(); i++) {
ImageButton imageButton = (ImageButton)tabsContainer.getChildAt(i);
imageButton.setImageTintMode(PorterDuff.Mode.SRC_IN);
if (i == position) {
imageButton.setImageTintList(getResources().getColorStateList(R.color.ib_color_list));
} else {
imageButton.setImageTintList(getResources().getColorStateList(R.color.ib_color_list_normal));
}
}
}
4.寫在最后的話
PagerSlidingTabStrip，總體來說簡潔方便，如果開發者想集成自己的一些內容，比如說Indicator改成其他的形狀，或者說想做到既有文字又有圖片的效果，都可以自己修改代碼來實現，比較的方便。
我的CSDN博客原文地址：
http://blog.csdn.net/poorkick/article/details/53868426
