PagerSlidingTabStrip從頭到腳

簡(jiǎn)介

PagerSlidingTabStrip，是我個(gè)人經(jīng)常使用到的一個(gè)和ViewPager配合的頁(yè)面指示器，可以滿足開發(fā)過(guò)程中常用的需求，如類似于今日頭條的首頁(yè)新聞內(nèi)容導(dǎo)航欄等等，之前自己開發(fā)的JuheNews和正在開發(fā)的GankIOClient均有使用到它，所以想對(duì)其進(jìn)行一個(gè)全面的介紹。

JuheNews
GankIOClient

PagerSlidingTabStrip源碼地址：https://github.com/astuetz/PagerSlidingTabStrip

簡(jiǎn)單使用

  • 添加庫(kù)依賴
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"/>
  • 關(guān)聯(lián)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);
    }
}

  • 結(jié)果


    這里寫圖片描述
  • 后話
    看到這個(gè)效果，是不是很炸裂，如此的丑陋，上圖是什么屬性都沒有修改默認(rèn)的效果圖，接著我們看下源碼，看下可以從哪方面來(lái)進(jìn)行改造。

源碼解析

這個(gè)開源庫(kù)，簡(jiǎn)單點(diǎn)說(shuō)就是大家都非常熟悉的自定義View，所以，解讀的方式可以從自定義屬性到此視圖的構(gòu)造，onMeasure,onLayout, onDraw等等

  1. 自定義的屬性值
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="PagerSlidingTabStrip">
         <!--底部滑動(dòng)指示器的顏色-->
        <attr name="pstsIndicatorColor" format="color" />
        <!--底部用于給指示器滑動(dòng)的區(qū)域的顏色--> 
        <attr name="pstsUnderlineColor" format="color" />
        <!--分割線的顏色-->
        <attr name="pstsDividerColor" format="color" />
        <!--指示器的高度-->
        <attr name="pstsIndicatorHeight" format="dimension" />
        <!--底部區(qū)域的高度--> 
        <attr name="pstsUnderlineHeight" format="dimension" />
        <!--分割線與上下的間距--> 
        <attr name="pstsDividerPadding" format="dimension" />
        <!--每個(gè)Tab的左右邊距-->
        <attr name="pstsTabPaddingLeftRight" format="dimension" />
        <!--選中tab的滾動(dòng)偏移量,個(gè)人基本沒有用到過(guò)--> 
        <attr name="pstsScrollOffset" format="dimension" />
        <!--每個(gè)Tab的背景圖，StateListDrawable-->
        <attr name="pstsTabBackground" format="reference" />
        <!--是否根據(jù)tab均為位置，true的時(shí)候均分，默認(rèn)為false,一般都是使用默認(rèn)值-->
        <attr name="pstsShouldExpand" format="boolean" />
        <!--標(biāo)題文本是否大寫，默認(rèn)為true-->
        <attr name="pstsTextAllCaps" format="boolean" />
    </declare-styleable>
</resources>

看下大致的布局和屬性對(duì)號(hào)入座


屬性對(duì)應(yīng)圖
  1. PagerSlidingTabStrip.java類結(jié)構(gòu)
getter and setter

類中的getter和setter方法，基本上和上面的自定義屬性可以對(duì)上號(hào)，不僅可以在布局文件中定義，還可以通過(guò)java代碼進(jìn)行設(shè)置。

變量

類中使用到的變量，大部分都是和自定義屬性掛鉤的，主要關(guān)注幾個(gè)

  • ATTRS : 引用Android系統(tǒng)的兩個(gè)屬性，文本字體大小和字體顏色
  • pageListener：內(nèi)部使用的OnPagerChangeListener,通過(guò)setViewPager實(shí)現(xiàn)和ViewPager的聯(lián)動(dòng)
  • delegatePageListener ：暴露給開發(fā)者的接口，類本身使用到了兩個(gè)OnPageChangeListener，一個(gè)用來(lái)實(shí)現(xiàn)自己的邏輯，而這個(gè)則是留給開發(fā)者實(shí)現(xiàn)自己需要針對(duì)ViewPager的頁(yè)面變化的邏輯||tabsContainer|內(nèi)部容器，用戶所見文本指示器和圖標(biāo)指示器的父節(jié)點(diǎn)，所以，如果需要針對(duì)文本指示器或者是圖標(biāo)指示器做什么操作，通過(guò)這個(gè)查找孩子節(jié)點(diǎn)即可
關(guān)鍵方法

  • IconTabProvider
    類中比較關(guān)鍵的一些內(nèi)容，接口IconTabProvider，ViewPager對(duì)應(yīng)的Adapter實(shí)現(xiàn)該方法并返回每個(gè)ViewPager對(duì)應(yīng)的圖標(biāo)即可實(shí)現(xiàn)圖標(biāo)指示器。

  • PageListener <用戶自定義的OnPagerListener的事件處理集成于此處>

private class PageListener implements OnPageChangeListener {
    @Override
    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
        //存儲(chǔ)當(dāng)前位置信息
        currentPosition = position;
        currentPositionOffset = positionOffset;
        //滑動(dòng)到子視圖
        scrollToChild(position, (int) (positionOffset * tabsContainer.getChildAt(position).getWidth()));
        invalidate();//觸發(fā)重繪
        //用戶自定義的OnPagerChangeListener事件之onPagerScrolled
        if (delegatePageListener != null) {
            delegatePageListener.onPageScrolled(position, positionOffset, positionOffsetPixels);
        }
    } 

    @Override
    public void onPageScrollStateChanged(int state) {
        //已經(jīng)滑動(dòng)完成，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) {
        //這里類內(nèi)部沒有做什么處理，只處理用戶自定義的OnPagerSelected方法
        if (delegatePageListener != null) {
            delegatePageListener.onPageSelected(position);
        }
    }
}
/**
 *滑動(dòng)指定子視圖
*/
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構(gòu)造方法
    構(gòu)造方法的內(nèi)容不多，基本上全是基本屬性的獲取，自定義View中常用的TypedArray ，記得回收recycle()，這里關(guān)注一下TypedValue.applyDimension方法的使用，全部轉(zhuǎn)換成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);

    /* 是否延伸，默認(rèn)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();
    
    // 設(shè)置Indicator顏色
    rectPaint.setColor(indicatorColor);

    // 獲取當(dāng)前選中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) {
    //結(jié)合下一個(gè)Tab獲取當(dāng)前要繪制的indicator的位置,這里的currentPositionOffset 比較關(guān)鍵，可以看到這個(gè)值是與ViewPager相關(guān)的，在onPagerScrolled方法中，這個(gè)值在不斷的更新
    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
    一個(gè)用來(lái)與ViewPager聯(lián)動(dòng)，一個(gè)用來(lái)處理自定義的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綜合用法

  • 文本指示器選中后文本大小和顏色變化


    實(shí)現(xiàn)的效果

    關(guān)鍵點(diǎn)在于實(shí)現(xiàn)自己的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));
        }
    }
}

  • 圖標(biāo)指示器選中圖標(biāo)顏色變化


    這里寫圖片描述

關(guān)鍵點(diǎn)在于實(shí)現(xiàn)自己的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，總體來(lái)說(shuō)簡(jiǎn)潔方便，如果開發(fā)者想集成自己的一些內(nèi)容，比如說(shuō)Indicator改成其他的形狀，或者說(shuō)想做到既有文字又有圖片的效果，都可以自己修改代碼來(lái)實(shí)現(xiàn)，比較的方便。

我的CSDN博客原文地址：
http://blog.csdn.net/poorkick/article/details/53868426

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容