美文网首页Android开发经验谈Android技术知识Android开发
手把手讲解全能型GreenTabLayout研发全攻略

手把手讲解全能型GreenTabLayout研发全攻略

作者: 波澜步惊 | 来源:发表于2020-04-01 17:08 被阅读0次

    前言

    上一篇文章讲了如何 从ViewPager的源码入手,定义自己的ViewPager滑动特效。ViewPager由于有自己的动画接口接口,我们可以直接拿到当前ItemView,以及它的position位置参数,因此可以做出任何我们能够想到的特效。

    但是,TabLayout,谷歌貌似就没有那么周到的服务,像是今日头条那样的TabLayout 滑动时的 文字部分颜色变化,还有很多其他app中出现的下方横条indicator长短变化的 特效,还有更多其他特效。如果使用谷歌原生的TabLayout是无法做到的,这个时候就需要我们 自定义TabLayout,但是,说是自定义,前提还是要参照 谷歌的TabLayout源码,然后在其基础上进行再创作。因为,从0开始要制作一个 和谷歌原生同样质量的控件,包括滑动流畅度和边界控制,并且具有良好的扩展性,并没有那么容易,如果存在改造原生TabLayout的可能性,改造的代价要小于 从0创造。所以,优先 阅读源码,探寻这种可能性,如果没有可能性,再去从0创造。

    Demo的地址为:https://github.com/18598925736/StudyTabLayout/tree/hank_v1

    正文大纲

    • 源码分析
    • 开发思路
    • 开始搬砖
      • 一. 尊重原著
      • 二. 联动滑动
      • 三.特效解耦

    正文

    源码分析

    创建一个androidStudio工程,然后写一个TabLayout+ViewPager效果,之后进入看TabLayout的java源码。源码总长度超过了3000行。但是其中大部分都是注释以及空行,无需害怕。

    从我们对TabLayout UI 上的感官印象,可以得知,它应该是一个横向可滚动的 HorizontalScrollView, 它包含两个关键的元素,一个是文字部分的 TabView,一个是 下划线 Indicator .

    image-20200320164934056-1585550575830.png

    我们的动画也是围绕这两个部分,所以明确这次源码分析的最终目标:

    1. TabView 在TabLayout中是如何 添加 进去的

    2)Indicator在TabLayout中是如何 绘制 进去的

    TabView明显是一个以TextView为基础,所以是添加到TabLayout 中;Indicator是 一个图形,所以应该是绘制的。

    带上目标来探索源码,事半功倍。

    开工。先看TabView.

    从注释中得知,TabLayout其实可以主动去addTab来添加子view,那就从 addTab方法来入手。

    image-20200320165636066-1585550578377.png

    注释中有这么一句。

    tabLayout.addTab(tabLayout.newTab().setText("Tab 1"));
    

    找到一个关键方法,关于Tab是如何创建的。

      public Tab newTab() {
        Tab tab = createTabFromPool();
        tab.parent = this;
        tab.view = createTabView(tab);
        return tab;
      }
    

    从pool中创建,并且 指定了当前TabLayout为它的parent,并且createTabView(tab)然后 给他的view属性赋值。

    后续还有一句:setText("Tab 1") , 在创建出来的Tab上调用setText方法,进入看看:

    public Tab setText(@Nullable CharSequence text) {
      if (TextUtils.isEmpty(contentDesc) && !TextUtils.isEmpty(text)) {
        // If no content description has been set, use the text as the content description of the
        // TabView. If the text is null, don't update the content description.
        view.setContentDescription(text);
      }
    
      this.text = text;
      updateView();
      return this;
    }
    

    由此得知,我们在上图中所看到的title0 文本内容,就是传到了这个方法(可以debug验证)。那么 这里的 text 属性用在了什么位置呢?内部类TabView的updateTextAndIcon()方法

    image-20200320173530548-1585550586641.png

    从这段中可以得出,我们的文本内容,最终传给了 参数 textView : textView.setText(text);

    追踪updateTextAndIcon()的调用位置,看看这个textView是什么。

    经过4处调用位置的检查,

    image-20200320174011680-1585550589010.png

    发现它是:

    image-20200320174106769-1585550590865.png

    这两个属性之一。TabView的两个TextView类型的成员变量。

    那么只需要关心这两个TextView是如何添加到TabView中去的。最后发现 customTextView没有被addView,而唯一一处addView(textView)的代码如下:

        private void inflateAndAddDefaultTextView() {
          ViewGroup textViewParent = this;
          if (BadgeUtils.USE_COMPAT_PARENT) {
            textViewParent = createPreApi18BadgeAnchorRoot();
            addView(textViewParent);
          }
          this.textView =
              (TextView)
                  LayoutInflater.from(getContext())
                      .inflate(R.layout.design_layout_tab_text, textViewParent, false);
          textViewParent.addView(textView);// 在这里添加的
        }
    

    所以,可以断定,我们之前设置的 title0 这个文本被设置到 了 内部类TabView(一个线性布局)的TextView成员中。

    所以 title0 这个文本 的所在对象,从小到大,依次是,

    原生TextView -> 内部类TabView -> 内部类Tab -> 原生TabLayout

    基于这样的认知,要探究一下是不是存在文字被重新绘制的可能性。

    要想对TextView根据需求重新绘制,那么除非可以像ViewPager一样,把View以及当前Position反馈到最外层。Position暂且不管,先看 最终的TextView.

    经过一番搏斗,发现并没有这样的接口。。。所以没办法了。TabView 在TabLayout中是如何 添加 进去的 的探索结果表明,谷歌并没有给机会让我们 定制文本部分的内容特效。所以,放弃吧。

    然后从头看起,如果以 Indicator在TabLayout中是如何 绘制 进去的 为准来进行探索。

    image-20200321201914158-1585550594385.png

    这里有两个方法,configureTab 方法,只是对tab对象进行了 保存。看addTabView方法。

    image-20200321202058037-1585550596434.png

    这里的tab.view 是 TabView对象,它最终添加到了 slidingTabIndicator 中去。而 slidingTabIndicator 它则是一个 内部类,同样是线性布局,方向为横向,它把TabView对象添加进去之后,多个TabView就会横向排列。而底下那一个横向的indicator,则是由 画笔 selectedIndicatorPaint 绘制而成。根据如下:

    image-20200321203148966-1585550597890.png
    image-20200321203307642-1585550599417.png

    得出最终结论:TabLayout的设计布局如下图:

    image-20200321204132776-1585550603705.png

    最后我探索了一下,indicator 横条,谷歌是不是有提供对外接口来编辑特效。倒是 内部类 SlidingTabIndicator 有一个ValueAnimator indicatorAnimator 在控制 横条滑动的位置动画,使用的是 FastOutSlowInInterpolator 插值器。但是对我们自定义特效没啥用。

    最后结论,放弃治疗了。在TabLayout上,谷歌确实不给机会。


    开发思路

    谷歌工程师设计的控件是针对全世界的开发者和使用者,肯定会考虑周全,支持很多自定义属性,细节细致入微,所以代码看上起会显得非常复杂,难以读懂,而且这么多英文注释,你懂的,反正我看他们的注释一边看一边猜。

    然而我们的UI姐姐有自己的要求,所以如果我们可以做自己的UI控件,就可以摆脱谷歌源码的控制,随心所欲地控制TabLayout的视觉效果。

    今天本文的最终目的:

    是开发一个 绿色版的 GreenTabLayout,去掉谷歌原本一些繁杂的设定,增添开发常用的自定义属性,并且开放 自定义效果的接口,让其他开发者可以在不改动我原本代码的前提下,编辑自己的动画特效。

    上面TabLayout UI层级图,展示了谷歌工程师的设计思路,此思路没有问题,我们可以参照它。

    但是一步达成最终效果不太可能,我们分阶段来达成效果:

    • 尊重原著

      GreenTabLayout 必须与原TabLayout相差不大,要有文字title标题,要有indicator横条

    • 联动滑动

      自定义TabLayout必须能够和ViewPager一样,产生同样的联动滑动效果,包括横条的滑动和 标题部分的滑动

    • 特效解耦

      自定义TabLayout 把 标题栏的View,indicator横条View,对外提供方便的动画特效定制接口,符合开闭法则.


    开始搬砖

    确定了基本思路,接下来就要脚踏实地了。在Kotlin语言如此之香的潮流下,我也追求一波时尚,开发将采用Kotlin编码,最大程度节省代码量,使用kotlin"域"的概念隔离程序逻辑,尽可能使源码可读性提高。

    一. 尊重原著

    要实现与原生TabLayout一样的效果,可以抄谷歌的作业, 原本的UI层级,照搬即可。

    下载源码之后,git checkout 4ed2 运行看效果

    从外到内有三层:

    最外层

    它的最外层是一个横向可滚动的 HorizontalScrollView 的子类,同时它提供addTabView方法 供外界添加item

    /**
     * 最外层
     */
    class HankTabLayout : HorizontalScrollView {
        constructor(ctx: Context) : super(ctx) {
            init()
        }
    
        constructor(ctx: Context, attributes: AttributeSet) : super(ctx, attributes) {
            init()
        }
    
        constructor(context: Context, attrs: AttributeSet?, defStyleAttr: Int) : super(context, attrs, defStyleAttr) {
            init()
        }
    
    
        private lateinit var indicatorLayout: IndicatorLayout
    
        private fun init() {
            indicatorLayout = IndicatorLayout(context)
            val layoutParams = LinearLayout.LayoutParams(WRAP_CONTENT, MATCH_PARENT)
            addView(indicatorLayout, layoutParams)
    
            overScrollMode = View.OVER_SCROLL_NEVER
            isHorizontalScrollBarEnabled = false
        }
    
        fun addTabView(text: String) {
            indicatorLayout.addTabView(text)
        }
    
    }       
    

    中间层

    中间层,是一个横向线性布局,宽度自适应,根据内容而定,提供addTabView方法,用来添加 TabView到自身,同时 绘制 indicator横条, 横条与当前选中的tabView等长并处于最下方.

    绘制横条可能有多种方式,这里借鉴了谷歌的思路,使用Drawable.draw(canvas) ,好处就是,可以指定drawable图片,使用图片内容绘制在canvas上。后续会有体现。

    /**
     * 中间层 可滚动的
     */
    class IndicatorLayout : LinearLayout {
        constructor(ctx: Context) : super(ctx) {
            init()
        }
    
        private fun init() {
            setWillNotDraw(false) // 如果不这么做,它自身的draw方法就不会调用
        }
    
        var indicatorLeft = 0
        var indicatorRight = 0
    
        /**
         * 作为一个viewGroup,有可能它不会执行自身的draw方法,这里有一个值去控制,好像是 setWillNotDraw
         */
        override fun draw(canvas: Canvas?) {
            val indicatorHeight = dpToPx(context, 4f)// 指示器高度
            // 现在貌似应该去画indicator了
            // 要绘制,首先要确定范围,左上右下
            var top = height - indicatorHeight
            var bottom = height
            Log.d("drawTag", "$indicatorLeft    $indicatorRight   $top     $bottom")
            // 现在只考虑在底下的情况
            var selectedIndicator: Drawable = GradientDrawable()
            selectedIndicator.setBounds(indicatorLeft, top, indicatorRight, bottom)
            DrawableCompat.setTint(selectedIndicator, resources.getColor(R.color.c2))
            selectedIndicator.draw(canvas!!)
            super.draw(canvas)
        }
    
        fun updateIndicatorPosition(tabView: TabView, left: Int, right: Int) {
            indicatorLeft = left
            indicatorRight = right
            postInvalidate()//  刷新自身,调用draw
            // 把其他的都设置成未选中状态
            for (i in 0 until childCount) {
                val current = getChildAt(i) as TabView
                if (current.hashCode() == tabView.hashCode()) {// 如果是当前被点击的这个,那么就不需要管
                    current.setSelectedStatus(true) // 选中状态
                } else {// 如果不是
                    current.setSelectedStatus(false)// 非选中状态
                }
            }
        }
    
        /**
         * 但是onDraw一定会执行
         */
        override fun onDraw(canvas: Canvas?) {
            super.onDraw(canvas)
        }
    
        // 对外提供方法,添加TabView
        fun addTabView(text: String) {
            val tabView = TabView(context, this)
            val param = LayoutParams(WRAP_CONTENT, WRAP_CONTENT)
            param.setMargins(dpToPx(context, 10f))
    
            val textView = TextView(context)
           textView.setBackgroundDrawable(resources.getDrawable(R.drawable.my_tablayout_textview_bg))
            textView.text = text
            textView.gravity = Gravity.CENTER
            textView.setPadding(dpToPx(context, 15f))
            textView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 20f)
            textView.setTextColor(resources.getColor(TabView.unselectedTextColor))
            tabView.setTextView(textView)
    
            addView(tabView, param)
            postInvalidate()
    
            if (childCount == 1) {
                val tabView0 = getChildAt(0) as TabView
                tabView0.performClick()
            }
        }
    }
    

    最里层

    说是最里层,其实这里分为两小层,一个是TabView(继承线性布局),一个是TextView(用来展示 title),

    提供点击事件,和状态切换的方法setSelectedStatus(boolean)

    /**
     * 最里层TabView
     */
    class TabView : LinearLayout {
        private lateinit var titleTextView: TextView
        private var selectedStatue: Boolean = false
        private var parent: IndicatorLayout
    
        companion object {
            const val selectedTextColor = R.color.cf
            const val unselectedTextColor = R.color.c1
        }
    
        constructor(ctx: Context, parent: IndicatorLayout) : super(ctx) {
            init()
            this.parent = parent
        }
    
        fun setTextView(textView: TextView) {
            titleTextView = textView
            removeAllViews()
            val param = LayoutParams(WRAP_CONTENT, MATCH_PARENT)
            addView(titleTextView, param)
    
            titleTextView.setOnClickListener {
                parent.updateIndicatorPosition(this, left, right)
            }
        }
    
        private fun init() {
        }
    
        fun setSelectedStatus(selected: Boolean) {
            selectedStatue = selected
            if (selected) {
                titleTextView.setTextColor(resources.getColor(R.color.cf))
            } else {
                titleTextView.setTextColor(resources.getColor(R.color.c1))
            }
        }
    
    }
    

    初阶效果

    做完这些,基本就呈现出下图的状态:

    尊重原著.gif

    上一半是原生TabLayout,用来对比,下一半是刚刚完成的效果。但是和上面的原生TabLayout比起来. 第一步完成。从开始写代码,到完成这个效果,一直参考的 谷歌的代码。

    二. 联动滑动

    下载源码之后,git checkout a132 运行看效果

    布局层级已经完成,现在需要联动Viewpager的滑动参数,让GreenTabLayout 跟随ViewPager一起滑动。

    注册监听

    要实现联动,首先要知道,谷歌源码中,TabLayout是如何与ViewPager发生联动的,它们的联结点在哪里,请看代码:

    tabLayout.setupWithViewPager(viewpager)
    

    平时我们用 原生TabLayout,两者唯一发生交集的地方就是这里,进入看源码:

    image-20200330142618611.png

    显然他们的交集可能是某个回调监听,顺着这个线索,最终确定,上面的 pageChangeListener就是 联动滑动的交界点,这里把监听器传给ViewPager,ViewPager则可以把自己的滑动参数传递给TabLayout,TabLayout则做出相应的行为。

    监听器的源码为:

    private TabLayoutOnPageChangeListener pageChangeListener;
    
    public static class TabLayoutOnPageChangeListener implements ViewPager.OnPageChangeListener {
         @Override
        public void onPageScrolled(final int position, final float positionOffset, final int positionOffsetPixels) {
        ....
        }
         @Override
        public void onPageSelected(final int position) {
        ...
        }
        @Override
        public void onPageScrollStateChanged(final int state) {
        ...
        }
    }
    

    了解到这里,我们可以给 GreenTabLayuot 直接加上 这个接口实现

    class GreenTabLayout : HorizontalScrollView, ViewPager.OnPageChangeListener {
        @Override
        public void onPageScrolled(final int position, final float positionOffset, final int positionOffsetPixels) {
        ....
        }
         @Override
        public void onPageSelected(final int position) {
        ...
        }
        @Override
        public void onPageScrollStateChanged(final int state) {
        ...
        }
    }
    

    然后提供一个 相同的 setupWithViewPager(viewpager) 方法, 在内部,给ViewPager绑定监听,同时根据 viewPager的adapter内的 page数目,决定TabView的数目和每一个的标题。

    fun setupWithViewPager(viewPager: ViewPager) {
        this.mViewPager = viewPager
        viewPager.addOnPageChangeListener(this)// 注册监听
        val adapter = viewPager.adapter ?: return
        val count = adapter!!.count // 栏目数量
        for (i in 0 until count) {
            val pageTitle = adapter.getPageTitle(i)
            addTabView(pageTitle.toString())// 根据adapter的item数目,决定TabView的数目和每一个标题
        }
    }
    

    参数分析

    注册监听之后,Viewpager可以把自己的滑动参数的变化告知TabLayout,但是TabLayout如何去处理这个参数变化,还需要从参数的规律上去着手。重点分析 监听的 onPageScrolled 方法, 重点中的重点,则是前两个参数:position(当前page的index) 和 positionOffset(当前page的偏移百分比,小数表示的)

    为了研究规律,我们用上面刚刚完成的代码把GreenTabLayout和ViewPager连结上,然后打印日志onPageScrolled

    image-20200330145008704.png

    基本得出一个结论:

    position为0的,为当前选中的这个page,当慢慢从当前page划走时,它的positionOffset会从0慢慢变成1

    并且,如果手指分方向滑动试验,可知:

    当手指向左,positionOffset会递增,从0到极限值1,到达极限之后归0,同时 position递加1

    反之,手指向右,positionOffset会递减,从1 递减到0,从递减的那一刻开始,position递减1

    基于上面的规律,我们可以调试出 indicator横条动画的代码:

    ...
    override fun onPageScrolled(position: Int, positionOffset: Float, positionOffsetPixels: Int) {
            scrollTabLayout(position, positionOffset)
    }
    
    private fun scrollTabLayout(position: Int, positionOffset: Float) {
        // 如果手指向左划,indicator横条应该从当前位置,滑动到 下一个子view的位置上去,position应该+1
        // 如果手指向右滑动,position立即减1,indicator横条应该从当前位置向左滑动
            val currentTabView = indicatorLayout.getChildAt(position) as GreenTabView
            val currentLeft = currentTabView.left
            val currentRight = currentTabView.right
    
            val nextTabView = indicatorLayout.getChildAt(position + 1)
            if (nextTabView != null) {
                val nextLeft = nextTabView.left
                val nextRight = nextTabView.right
                
                Log.d("scrollTabLayout","当前index:${position}  left:${currentLeft} right:${currentRight}  " +" 目标index:${position + 1}  left:${nextLeft} right:${nextRight} positionOffset:${positionOffset}" )
    
                val leftDiff = nextLeft - currentLeft
                val rightDiff = nextRight - currentRight
    
                indicatorLayout.updateIndicatorPosition(
                    currentLeft + (leftDiff * positionOffset).toInt(),
                    currentRight + (rightDiff * positionOffset).toInt()
                )
            }
        }
    

    为什么这样就能正确区分滑动的方向?把日志打印出来一看就明白:

    这是手指向左划一格

    image-20200330151551105.png
    • 观察positionOffset的变化,从0 变为1,然后归零。

    • 而看横条的当前 left = 26,right=170, 以及 目标left=222,right=380 ,随着positionOffset的递增,横条会慢慢向右。

    • 而到达最后,positionOffset归零了,当前left 也变成了 目标的left = 222,right=380.

    横条向右平移完成。

    手指向右划一格,日志如下:

    image-20200330152206881.png
    • position先直接减1,positionOffset则从1慢慢变成0.

    • 横条从 left=26 right=170 的起始位置,向 目标 left=222,righ=380 移动,但是由于positionOffset是递减的,所以,横条的移动方向反而是 向左。一直到positionOffset为0,到达 left=26 right=170.

    横条向左平移也完成。

    整体平移

    横条虽然可以跟着viewPager的滑动而滑动,但是如果TabView已经排满了当前屏幕,横条到达了当前屏幕最右侧,viewPager上右侧还有内容还可以让手指向左滑动。此时,就必须滚动最外层布局,来让TabView显示出来。

    通过观察原生TabLayout,它会尽量让 当前选中的tabView位于 控件的横向居中的位置。而随着 ViewPager的当前page的变化,最外层GreenTabLayout也要发生横向滚动。

    所以我选择在 回调函数onPageSelected中执行滚动:

        class GreenTabLayout: HorizontalScrollView, ViewPager.OnPageChangeListener {
            ...
            override fun onPageSelected(position: Int) {
                val tabView = indicatorLayout.getChildAt(position) as GreenTabView
                if (tabView != null) {
                    indicatorLayout.updateIndicatorPositionByAnimator(tabView, tabView.left, tabView.right)
                }
            }
        }
    

    执行滚动的思路为:

    • 确定 当前选中的tabView的 矩形范围 tabView.getHitRect(tabViewBounds)
    • 确定 确定最外层GreenTbaLayout的矩形范围 getHitRect(parentBounds)
    • 计算两个矩形的x轴的中点,然后计算出两个中点的差值,差值就是需要滚动的距离
    • 使用属性动画进行平滑滚动
        /**
         * 用动画平滑更新indicator的位置
         * @param tabView 当前这个子view
         */
        fun updateIndicatorPositionByAnimator(
            tabView: GreenTabView,
            targetLeft: Int,
            targetRight: Int) {
            ...
            // 处理最外层布局( HankTabLayout )的滑动
            parent.run {
                tabView.getHitRect(tabViewBounds) //确定 当前选中的tabView的 矩形范围
                getHitRect(parentBounds) // 确定最外层GreenTbaLayout的矩形范围
                val scrolledX = scrollX // 已经滑动过的距离
                val tabViewRealLeft = tabViewBounds.left - scrolledX  // 真正的left, 要算上scrolledX
                val tabViewRealRight = tabViewBounds.right - scrolledX // 真正的right, 要算上scrolledX
    
                val tabViewCenterX = (tabViewRealLeft + tabViewRealRight) / 2
                val parentCenterX = (parentBounds.left + parentBounds.right) / 2
                val needToScrollX = -parentCenterX + tabViewCenterX //  差值就是需要滚动的距离
    
                startScrollAnimator(this, scrolledX, scrolledX + needToScrollX)
            }
        }
    
        /**
         * 用动画效果平滑滚动过去
         */
        private fun startScrollAnimator(tabLayout: GreenTabLayout, from: Int, to: Int) {
            if (scrollAnimator != null && scrollAnimator.isRunning) scrollAnimator.cancel()
            scrollAnimator.duration = 200
            scrollAnimator.interpolator = FastOutSlowInInterpolator()
            scrollAnimator.addUpdateListener {
                val progress = it.animatedValue as Float
                val diff = to - from
                val currentDif = (diff * progress).toInt()
                tabLayout.scrollTo(from + currentDif, 0)
            }
            scrollAnimator.start()
        }
    

    二阶效果

    完成到这里,就能达成下图中的效果:

    联动滑动.gif

    上半部分为原生TabLayout效果,下把那部分为 刚刚完成的效果,几乎没有差别了。

    当然,我们这是把TabLayout本地化,完成这些,仅仅用了kotlin 300多行代码。可见Kotlin在省代码方面,确实是一绝,比java简洁很多。

    三.特效解耦

    这一阶段主要做2件事:

    • 支持开发中的常用的UI设计要求,这个可以做成自定义属性
    • 开放无耦合接口,使得开发者可以使用该接口编辑 indicator横条 / TabView文本 的滑动特效,而不用改动GreenTabLayout的内部实现

    第一点,都是一些基础性的改造,就不赘述了,关于自定义属性的添加和使用,都是死框架,没什么好说的,下面,总结一下 我所支持的所有属性:

    盘点自定义属性

    TabView标题栏部分:

    属性名 意义 取值类型
    tabViewTextSize 标题字体大小 dimension|reference
    tabViewTextSizeSelected 选中后的标题字体大小 dimension|reference
    tabViewTextColor 标题字体颜色 color|reference
    tabViewTextColorSelected 选中后的标题字体颜色 color|reference
    tabViewBackgroundColor 标题区域背景色 color|reference
    tabViewTextPaddingLeft 标题区内边距左 dimension|reference
    tabViewTextPaddingRight 标题区内边距右 dimension|reference
    tabViewTextPaddingTop 标题区内边距上 dimension|reference
    tabViewTextPaddingBottom 标题区内边距下 dimension|reference
    tabViewDynamicSizeWhenScrolling 是否允许滚动时的字体大小渐变 boolean

    Indicator横条部分:

    属性名 意义 取值类型
    indicatorColor 横条颜色 color|reference
    indicatorLocationGravity 横条位置 枚举:TOP 放在顶部 / BOTTOM 放在底部
    indicatorMargin 横条间距,当indicatorLocationGravity为TOP时表示距离顶端的距离,BOTTOM时表示距离底部的距离 dimension|reference
    indicatorWidthMode 横条宽度模式 枚举:RELATIVE_TAB_VIEW 取TabView宽度的倍数 / EXACT 取精确值
    indicatorWidthPercentages 横条宽度百分比,当indicatorWidthMode 为 RELATIVE_TAB_VIEW时才会生效,表示横条宽度占TabView宽度的百分比 float(大于0)
    indicatorExactWidth 横条宽度精确值,当indicatorWidthMode 为 EXACT时才会生效,表示横条的精确宽度 dimension|reference
    indicatorHeight 横条高度 dimension|reference
    indicatorAlignMode 横条对其模式 枚举: LEFT / CENTER / RIGHT
    indicatorDrawable 横条drawable,可以指定横条的内容为图片 reference
    indicatorElastic 是否开启滚动时横条的弹性效果 boolean
    indicatorElasticBaseMultiple 当indicatorElastic开启时生效,表示弹性倍数,数字越大,弹性越明显 float

    其中大部分属性的处理都是基于非常基础的View控件知识和简单的数学计算,只有几点需要讲解说明:

    • tabViewDynamicSizeWhenScrolling 是否允许滚动时的字体大小渐变
    • indicatorElastic 是否开启滚动时横条的弹性效果

    这两点,都与 viewPager滑动时的参数变化有关系,所以处理这两个特性,需要结合参数变化规律

    较复杂属性处理

    • tabViewDynamicSizeWhenScrolling viewPager滚动时,标题的字体大小会发生渐变:
    标题栏字体大小渐变.gif
    class GreenTabLayout : HorizontalScrollView, ViewPager.OnPageChangeListener {
        ...
        override fun onPageScrolled(position: Int, positionOffset: Float, positionOffsetPixels: Int){
            Log.d("positionOffset", "$positionOffset")
            scrollTabLayout(position, positionOffset)
        }
        
        fun scrollTabLayout(position: Int, positionOffset: Float) {
            val currentTabView = indicatorLayout.getChildAt(position) as GreenTabView
            val currentLeft = currentTabView.left
            val currentRight = currentTabView.right
    
            val nextTabView = indicatorLayout.getChildAt(position + 1) // 目标TabView
            if (nextTabView != null) {
                val nextGreenTabView = nextTabView as GreenTabView
                dealAttrTabViewDynamicSizeWhenScrolling(// 关键代码 
                    positionOffset,
                    currentTabView,
                    nextGreenTabView
                )
                ...
            }
        }
        
        /**
         *  处理属性 tabViewDynamicSizeWhenScrolling
         */
        private fun dealAttrTabViewDynamicSizeWhenScrolling(
            positionOffset: Float,
            currentTabView: GreenTabView,
            nextTabView: GreenTabView
        ) {
            if (tabViewAttrs.tabViewDynamicSizeWhenScrolling) {
                if (positionOffset != 0f) {
                    // 在这里,让当前字体变小,next的字体变大
                    val diffSize =
                        tabViewAttrs.tabViewTextSizeSelected - tabViewAttrs.tabViewTextSize
                    when (mScrollState) {
                        ViewPager.SCROLL_STATE_DRAGGING -> {
                            currentTabViewTextSizeRealtime =
                                tabViewAttrs.tabViewTextSizeSelected - diffSize * positionOffset
                            currentTabView.titleTextView.setTextSize(
                                TypedValue.COMPLEX_UNIT_PX,
                                currentTabViewTextSizeRealtime
                            )
    
                            nextTabViewTextSizeRealtime =
                                tabViewAttrs.tabViewTextSize + diffSize * positionOffset
                            nextTabView.titleTextView.setTextSize(
                                TypedValue.COMPLEX_UNIT_PX,
                                nextTabViewTextSizeRealtime
                            )
    
                            settingFlag = false
                        }
                        ViewPager.SCROLL_STATE_SETTLING -> {
                            // OK,定位到问题,在 mScrollState 为setting状态时,positionOffset的变化没有 dragging时那么细致
                            // 只要不处理 SETTING下的字体大小变化,也可以达成效果
                            if (!settingFlag)
                               indicatorLayout.resetTabViewsStatueByAnimator(indicatorLayout[mCurrentPosition] as GreenTabView)
                            settingFlag = true
                        }
                    }
                }
            }
        }
    }
    

    处理思路依旧是围绕 onPageScrolled 的参数变化,核心方法为:dealAttrTabViewDynamicSizeWhenScrolling(..), 让当前tabView的文本渐渐变小,而nextTabView的文本逐渐变大。这里如果有疑问可以参照上文的 参数分析小章节。

    但是,有一个坑,就是当拖拽停止的时候,viewpager会有一个自动的回弹动作,如果这里没处理好,就会出现,字体大小突变的情况,和我要的平滑动画过渡不相符,所以,这里我做了一个特殊处理,当拖拽停止,也就是手指松开的时候,抓准 ViewPager的 SCROLL_STATE_SETTLING 状态刚刚进入的时机,使用属性动画平滑改变字体,核心代码就是上文代码块中的:indicatorLayout.resetTabViewsStatueByAnimator(indicatorLayout[mCurrentPosition] as GreenTabView) 这句话可以让 tabView的文本字体平滑地从 当前值(不确定,因为dragging状态是用户人为控制),变为 目标值(这是确定值,要么是 正常状态下的字体大小,要么是选中状态下的字体大小),由此完美解决字体平滑变化的问题。

    • indicatorElastic 滚动时,横条会拉伸和回缩,也是跟随 onPageScrolled的参数变化而变化

      关键代码在 SlidingIndicatorLayout.kt 中的 draw方法:

      override fun draw(canvas:Canvas?){
      ...
      
              val baseMultiple = parent.indicatorAttrs.indicatorElasticBaseMultiple // 基础倍数,决定拉伸
              val indicatorCriticalValue = 1 + baseMultiple
              val ratio =
                  if (parent.indicatorAttrs.indicatorElastic) {
                      when {
                          positionOffset >= 0 && positionOffset < 0.5 -> {
                              1 + positionOffset * baseMultiple // 拉伸长度
                          }
                          else -> {// 如果到了下半段,当offset越过中值之后ratio的值
                              indicatorCriticalValue - positionOffset * baseMultiple
                          }
                      }
                  } else 1f
              // 可以开始绘制
              selectedIndicator.run {
                  setBounds(
                      ((centerX - indicatorWidth * ratio / 2).toInt()),
                      top,
                      ((centerX + indicatorWidth * ratio / 2).toInt()),
                      bottom
                  )// 规定它的边界
                  draw(canvas!!)// 然后绘制到画布上
              }
      ...
      
      }
      

      这一段提出来特别说明,因为它代表了一种解题思路,我需要的效果是:

      viewPager滚动1格,我需要它在滚动一半的时候,横条拉伸到最长,从一半滚完的时候,横条回缩到应该的宽度

      但是,viewPager滚1格,positionOffset的变化是从0 到1(手指向右),或者是从1到0(手指向左),我需要把positionOffset在到达0.5的时候当作一个临界时间点,计算出 这个临界时间点上,indicator横条应该的长度。

      关键在于:在临界点0.5上,前半段的0->0.5的最终值,必须等于 后半段 0.5->1 的 开始值

      由于我是按照倍数来拉伸,所以,原始倍率是1。我还想用参数控制拉伸的程度,所以设计一个变量 baseMultiple(拉伸倍数,数值越大,拉伸越明显)

      列出公式

      • 前半段的ratio最终值 = 1(原始倍率)+ 0.5 * baseMultiple

      • 后半段的ratio值 = indicatorCriticalValue临界值) - 0.5 * baseMultiple

      • 前半段的ratio最终值 = 后半段的ratio值

      计算得出,indicatorCriticalValue(临界值) = 1 (原始倍率)+ baseMultiple

      于是就写出了上面的代码。

    三阶效果

    说了这么多,不如亲眼看一眼效果更佳实在,以上各项属性,下面的动态图基本都有体现, 具体效果可以按需定制,基本可以满足UI姐姐的各种骚操作要求,如果还不行,可以拿我的代码自行修改,我的代码注释应该比谷歌大佬要亲民很多。,欢迎fork,star...

    自定义属性效果.gif

    开放无耦合特效接口

    为什么生出这种想法?这个是源自:ViewPager的无耦合动画接口。

    Viewpager.setPageTransformer(true, MyPageTransformer(this, adapter.count))
    

    viewPager的setPageTransformer,可以传入一个 PageTransformer(接口)的实现类,从而控制ViewPager滑动时的动画,开发者可以自由定制效果,而不用关心ViewPager的内部实现。符合程序设计的开闭法则,让控件开发者和 控件使用者都省心省力。

    GreenTabView接口

    我在Demo中,提供了 GreenTabLayout的setupWithViewPager泛型方法,使用者可以传入 GreenTextView的子类.两段关键代码如下:

    open class GreenTextView : AppCompatTextView {
        constructor(context: Context, attrs: AttributeSet) : super(context, attrs)
        constructor(context: Context) : super(context)
    
        /**
         * 可重写,接收来自viewpager的position参数,做出随心所欲的textView特效
         *
         * @param isSelected 是不是当前选中的TabView
         * @param positionOffset 偏移值   0<= positionOffset <=1
         */
        open fun handlerPositionOffset(positionOffset: Float, isSelected: Boolean) {}
    
        /**
         * 如果发生了滑动过程中特效残留的情况,可以重写此方法用来清除特效
         */
        open fun removeShader(oldPosition: Int, newOldPosition: Int) {}
    
        /**
         *  添加特效
         */
        open fun addShader(oldPosition: Int, newOldPosition: Int) {}
    
        /**
         * 通知,viewPager 即将进入setting状态
         * @param positionOffset 当前offset
         * @param isSelected 是否是被选择的TabView
         * @param direction 滑动方向,大于0 表示向右回弹,小于0 表示向左回弹
         */
        open fun onSetting(positionOffset: Float, isSelected: Boolean, direction: Int) {}
    }
    
    class GreenTabLayout : HorizontalScrollView, ViewPager.OnPageChangeListener{
        ...
        fun <T : GreenTextView> setupWithViewPager(viewPager: ViewPager, t: T?) {
            ...
        }
    }
    

    你可以按照下面的模板使用这个接口:

    class MainActivity : AppCompatActivity() {
    
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContentView(R.layout.activity_main)
    
            val adapter = MyPagerAdapter(supportFragmentManager)
            hankViewpager.adapter = adapter
            hankViewpager.offscreenPageLimit = 3
            hankViewpager.setPageTransformer(true, MyPageTransformer(this, adapter.count))
            
            //*******************关键代码*****************
            hankTabLayout.setupWithViewPager(hankViewpager, GradientTextView(this))
            //*******************************************
            hankTabLayout2.setupWithViewPager(hankViewpager)
        }
        ....
     }
    

    GradientTextView是GreenTabView的一个子类,它的源码是:

    /**
     * 提供颜色渐变的TextView
     */
    class GradientTextView : GreenTextView {
        constructor(context: Context, attrs: AttributeSet) : super(context, attrs)
        constructor(context: Context) : super(context)
    
        private var mLinearGradient: LinearGradient? = null
        private var mGradientMatrix: Matrix? = null
        private lateinit var mPaint: Paint
        private var mViewWidth = 0f
        private var mTranslate = 0f
        private val mAnimating = true
    
        private val fontColor = Color.BLACK
        private val shaderColor = Color.YELLOW
    
        override fun onSizeChanged(w: Int, h: Int, oldw: Int, oldh: Int) {
            super.onSizeChanged(w, h, oldw, oldh)
            if (mViewWidth == 0f) {
                mViewWidth = measuredWidth.toFloat()
                if (mViewWidth > 0) {
                    mPaint = paint
                    mLinearGradient = LinearGradient(
                        0f,// 初始状态,是隐藏在x轴负向,一个view宽的距离
                        0f,
                        mViewWidth,
                        0f,
                        intArrayOf(fontColor, shaderColor, shaderColor, fontColor),
                        floatArrayOf(0f, 0.1f, 0.9f, 1f),
                        Shader.TileMode.CLAMP
                    )
                    mPaint.shader = mLinearGradient
                    mGradientMatrix = Matrix()
                }
            }
        }
    
        override fun onDraw(canvas: Canvas) {
            super.onDraw(canvas)
            if (mAnimating && mGradientMatrix != null) {
                mGradientMatrix!!.setTranslate(mTranslate, 0f)
                mLinearGradient!!.setLocalMatrix(mGradientMatrix)
            }
        }
    
    
        private inline fun dealSwap(positionOffset: Float, isSelected: Boolean) {
            // 如果不是初始值,那说明已经赋值过,那么用 参数positionOffset 和 它对比,来得出滑动的方向
            Log.d(
                "setMatrixTranslate",
                " positionOffset:$positionOffset  isSelected:$isSelected   "
            )
            // 来,先判定滑动的方向,因为方向会决定从哪个角度
            mTranslate = if (mPositionOffset < positionOffset) {// 手指向左
                if (isSelected) {// 如果当前是选中状态,那么 offset会从0到1 会如何变化?
                    mViewWidth * positionOffset // OK,没问题。
                } else {
                    -mViewWidth * (1 - positionOffset)
                }
            } else {// 手指向右
                if (isSelected) {// 如果当前是选中状态,那么 offset会从0到1 会如何变化?
                    -mViewWidth * (1 - positionOffset) // OK,没问题。
                } else {
                    mViewWidth * positionOffset
                }
            }
            postInvalidate()
        }
    
        /**
         * 由外部参数控制shader的位置
         * @param positionOffset 只会从0到1变化
         * @param isSelected 是否选中
         */
        override fun handlerPositionOffset(positionOffset: Float, isSelected: Boolean) {
    
            if (mPositionOffset == -1f) {// 如果你是初始值
                mPositionOffset = positionOffset // 那就先赋值
            } else {
                dealSwap(positionOffset, isSelected)
            }
        }
    
        override fun removeShader(direction: Int) {
            Log.d("removeShaderTag", "要根据它当前的mTranslate位置决定从哪个方向消失  mTranslate:$mTranslate")
            mTranslate = mViewWidth
            postInvalidate()
        }
    
        override fun addShader(direction: Int) {
            // 属性动画实现shader平滑移动
            val from =
                if (direction < 0) {
                    -mViewWidth
                } else {
                    mViewWidth
                }
            startAnimator(from, 0f)
        }
    
        override fun onSetting(positionOffset: Float, isSelected: Boolean, direction: Int) {
            Log.d(
                "onSettingTag",
                "isSelected:$isSelected   positionOffset:$positionOffset direction:$direction"
            )
            mPositionOffset = -1f
    
            val targetTranslate = if (isSelected) {
                0f
            } else {
                if (direction > 0f) {// 向右回弹
                    mViewWidth
                } else {
                    Log.d("onSettingTag2", "难道这里还要分情况么?mTranslate:$mTranslate  mViewWidth:$mViewWidth")
                    if (mTranslate == mViewWidth || mTranslate == -mViewWidth) {
                        mTranslate // 如果已经到达了最右边,那就保持你这个样子就行了, 可是你是怎么到最右边的?
                    } else
                        -mViewWidth
                }
    
            }
            val thisTranslate = mTranslate
            startAnimator(thisTranslate, targetTranslate)
        }
    
        private fun startAnimator(from: Float, targetTranslate: Float) {
            if (animator != null) animator?.cancel()
            // 属性动画实现shader平滑移动
    
            animator = ValueAnimator.ofFloat(from, targetTranslate)
            animator?.run {
                duration = animatorDuration
                addUpdateListener {
                    mTranslate = it.animatedValue as Float
                    postInvalidate()
                }
                start()
            }
        }
    
        private var mPositionOffset: Float = -1f
    
        private val animatorDuration = 200L
        private var animator: ValueAnimator? = null
    }
    

    运行效果:请注意看下图的上面半部分,下半部分只是没有加特效的对比。理论上,利用现在的参数,可以定制出想要的任何效果,下图只是我的一些效果测试。

    文字渐变最终效果.gif

    注意,使用了Shader特效之后,原本的 titleTextView字体颜色可能会失效,这是由shader机制决定的,但是依然可以用shader控制字体的颜色,运行Demo,阅读源码,很快就能得出答案。

    既然这是一个开放接口,那么所能达成的效果,就不仅仅是上图中所示, 利用 handlerPositionOffset的几个参数,发挥想象力(或者UI姐姐发挥想象力),想要做出任何你希望的效果,只是时间问题。

    Indicator接口

    同样,针对Indicator横条的绘制,你也可以完全自定义,使用自己的实现方式,强制接管 原代码中的绘制逻辑

    接口在 GreenTabLayout.kt 中,入口方法为:

        /**
         * 注意,使用了此方法,传入了非空的CustomDrawHandler实现类对象,
         * 原本indicator的所有属性都会失效,因为indicator的绘制工作,全部由CustomDrawHandler接管
         */
        fun setIndicatorDrawHandler(customDrawHandler: SlidingIndicatorLayout.CustomDrawHandler?) {
            indicatorLayout.customDrawHandler = customDrawHandler
        }
    

    接口为:SlidingIndicatorLayout.kt类中的 CustomDrawHandler ,提供一个draw方法,方法内提供2个关键参数,第一个是 SlidingIndicatorLayout 对象,第二个是,画布canvas对象, 前者可以让我们拿到任何想要拿的参数,后者,让我们可以动用想象力,把想象的特效,绘制在画布上。

        interface CustomDrawHandler {
            fun draw(indicatorLayout: SlidingIndicatorLayout, canvas: Canvas?)
        }
    
        var customDrawHandler: CustomDrawHandler? = null
    

    使用方法:

    class MainActivity : AppCompatActivity() {
    
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContentView(R.layout.activity_main)
    
            val adapter = MyPagerAdapter(supportFragmentManager)
            hankViewpager.adapter = adapter
            hankViewpager.offscreenPageLimit = 3
            hankViewpager.setPageTransformer(true, MyPageTransformer(this, adapter.count))
            hankTabLayout.setupWithViewPager(hankViewpager, GradientTextView(this))
    
            hankTabLayout.setIndicatorDrawHandler(CustomDrawHandlerImpl(this))
    
            hankTabLayout2.setupWithViewPager(hankViewpager)
        }
    
        
        class CustomDrawHandlerImpl : SlidingIndicatorLayout.CustomDrawHandler {
            val context: Context
    
            constructor(context_: Context) {
                context = context_
            }
    
            override fun draw(indicatorLayout: SlidingIndicatorLayout, canvas: Canvas?) {
                val paint = Paint()
                paint.color = context.resources.getColor(R.color.c1)
                val fraction =
                    (indicatorLayout.parent.mCurrentPosition.toFloat() + 1) / indicatorLayout.childCount.toFloat()// 分数
                val left = indicatorLayout.parent.scrollX
                val right =
                    (indicatorLayout.parent.scrollX + indicatorLayout.parent.measuredWidth * fraction).toInt()
                val rect = Rect(left, 0, right, dpToPx(context, 10f))
                canvas?.drawRect(rect, paint)
            }
        }
    
        ...
    }
    
    

    运行效果请看下图上半部分(下面一半仍然是用来对比),我实现了一个用indicator来记录当前滑动的进度的特效,只作为简单效果的展示,表示它可以实现任何你能想到的indicator动效,上面的代码,我只绘制了矩形,其实还可以绘制任何其他图形,任你想像。

    indicator特效解耦.gif

    结语

    Demo的地址为:https://github.com/18598925736/StudyTabLayout/tree/hank_v1

    请下载运行最新版本代码看效果。

    至此,所有内容放送完毕,全文技术从立意到实践编码,再到文章出炉,历时半月,终于功成。由于只是业余时间研究所得,细节上还没有打磨得十分圆满。

    写出一个类似这样的控件并不难,技术上基本没有什么纵深,但是涉及面很广,而且一旦开头的思路错了,后续隐患无穷。我的思维是,向源码学习,将基础架构学到手,具体的实操,我们再自己把握。谷歌的注释虽然有些生涩难懂,但是大体思维,只要认真研读源码,总是能得到启发的。

    希望能给其他开发者带来新的思路和借鉴。

    欢迎 看到的各位大佬留言交流,批评指正。谢过!

    相关文章

      网友评论

        本文标题:手把手讲解全能型GreenTabLayout研发全攻略

        本文链接:https://www.haomeiwen.com/subject/bpyauhtx.html