ViewPager2坑点

ViewPager2坑点

• 自从google出了viewpager2之后，就跃跃欲试地想把viewpager替换了，可是一替换问题就来了

ViewPager2嵌套RecyclerView导致的滑动问题

• 我们知道ViewPager2内部是改为用RecyclerView实现了，因此ViewPager2的adapter和RecyclerView的adapter基本是一样的
• 假如现在的需求是每个tab页里都要展示列表，那么自然想到用RecyclerView去实现，但刚刚也说了ViewPager2内部也是RecyclerView，这就造成RecyclerView的嵌套，会产生滑动问题，比如列表向上滑到底部时，竟然发生了tab切换，这是因为滑动到底部后的事件让ViewPager2消费了，同理，向下滑动到底部时也会发生tab切换
• 可是这样的问题在ViewPager并没有出现啊，难道是google工程师改出bug了
• 原因自然不是出bug了，而是ViewPager2扩充了ViewPager的功能，如垂直滚动，由于ViewPager2功能的增多，灵活性自然也要放开，像ViewPager这种满足单一场景时确实可以帮你解决滑动冲突，但ViewPager2由于增加了垂直滚动，就不能再套用之前那套滑动冲突的解决方案，而是要交给开发者自行去解决，因为google也不知道出现这种冲突后哪种方案才是你所需要的，自然不会多加处理
• 但是这样的话对于那些只是简单想把ViewPager替换为ViewPager2的伙伴来说确实就比较痛苦了，必须自己去解决这样的冲突问题，因此不要随便将ViewPager替换为ViewPager2，必须要充分做好自己解决冲突的心理准备后再下手
• 上面大概分析了冲突的来源和原因，那么怎么解决这种问题呢
• 问题一般都是从ViewPager2入手或者子项的RecyclerView入手，但由于ViewPager2已经被声明为final了，所以只能从子项的RecyclerView入手了
• 先来分析RecyclerView的onInterceptTouchEvent方法，看看里面是怎么拦截的

// androidx.recyclerview.widget.RecyclerView
	 @Override
    public boolean onInterceptTouchEvent(MotionEvent e) {
        if (mLayoutSuppressed) {
            // When layout is suppressed,  RV does not intercept the motion event.
            // A child view e.g. a button may still get the click.
            return false;
        }

        // Clear the active onInterceptTouchListener.  None should be set at this time, and if one
        // is, it's because some other code didn't follow the standard contract.
        mInterceptingOnItemTouchListener = null;
        if (findInterceptingOnItemTouchListener(e)) {
            cancelScroll();
            return true;
        }

        if (mLayout == null) {
            return false;
        }

        final boolean canScrollHorizontally = mLayout.canScrollHorizontally();
        final boolean canScrollVertically = mLayout.canScrollVertically();

        if (mVelocityTracker == null) {
            mVelocityTracker = VelocityTracker.obtain();
        }
        mVelocityTracker.addMovement(e);

        final int action = e.getActionMasked();
        final int actionIndex = e.getActionIndex();

        switch (action) {
            case MotionEvent.ACTION_DOWN:
                if (mIgnoreMotionEventTillDown) {
                    mIgnoreMotionEventTillDown = false;
                }
                mScrollPointerId = e.getPointerId(0);
                mInitialTouchX = mLastTouchX = (int) (e.getX() + 0.5f);
                mInitialTouchY = mLastTouchY = (int) (e.getY() + 0.5f);

                if (mScrollState == SCROLL_STATE_SETTLING) {
                    getParent().requestDisallowInterceptTouchEvent(true);
                    setScrollState(SCROLL_STATE_DRAGGING);
                    stopNestedScroll(TYPE_NON_TOUCH);
                }

                // Clear the nested offsets
                mNestedOffsets[0] = mNestedOffsets[1] = 0;

                int nestedScrollAxis = ViewCompat.SCROLL_AXIS_NONE;
                if (canScrollHorizontally) {
                    nestedScrollAxis |= ViewCompat.SCROLL_AXIS_HORIZONTAL;
                }
                if (canScrollVertically) {
                    nestedScrollAxis |= ViewCompat.SCROLL_AXIS_VERTICAL;
                }
                startNestedScroll(nestedScrollAxis, TYPE_TOUCH);
                break;

            case MotionEvent.ACTION_POINTER_DOWN:
                mScrollPointerId = e.getPointerId(actionIndex);
                mInitialTouchX = mLastTouchX = (int) (e.getX(actionIndex) + 0.5f);
                mInitialTouchY = mLastTouchY = (int) (e.getY(actionIndex) + 0.5f);
                break;

            case MotionEvent.ACTION_MOVE: {
                final int index = e.findPointerIndex(mScrollPointerId);
                if (index < 0) {
                    Log.e(TAG, "Error processing scroll; pointer index for id "
                            + mScrollPointerId + " not found. Did any MotionEvents get skipped?");
                    return false;
                }

                final int x = (int) (e.getX(index) + 0.5f);
                final int y = (int) (e.getY(index) + 0.5f);
                if (mScrollState != SCROLL_STATE_DRAGGING) {
                    final int dx = x - mInitialTouchX;
                    final int dy = y - mInitialTouchY;
                    boolean startScroll = false;
                    if (canScrollHorizontally && Math.abs(dx) > mTouchSlop) {
                        mLastTouchX = x;
                        startScroll = true;
                    }
                    if (canScrollVertically && Math.abs(dy) > mTouchSlop) {
                        mLastTouchY = y;
                        startScroll = true;
                    }
                    if (startScroll) {
                        setScrollState(SCROLL_STATE_DRAGGING);
                    }
                }
            }
            break;

            case MotionEvent.ACTION_POINTER_UP: {
                onPointerUp(e);
            }
            break;

            case MotionEvent.ACTION_UP: {
                mVelocityTracker.clear();
                stopNestedScroll(TYPE_TOUCH);
            }
            break;

            case MotionEvent.ACTION_CANCEL: {
                cancelScroll();
            }
        }
        return mScrollState == SCROLL_STATE_DRAGGING;
    }

• 从最后的return我们可以知道拦不拦截事件就看mScrollState == SCROLL_STATE_DRAGGING是否满足了，由于滑动到底部后就会调用到RecyclerView.cancelScroll()方法，之后就会导致 mScrollState == SCROLL_STATE_DRAGGING 变为false,从而不拦截事件，事件自然就交给父视图ViewPager2去处理了，这样ViewPager2通过计算后就会认为发生了tab切换，因为我们手指在上滑过程中一般都不是绝对垂直的，而是有斜度的，这个斜度就会导致ViewPager2认为发生了横向滑动
• 此时就有一种方案了，修改RecyclerView的拦截逻辑将事件消费掉，但修改RecyclerView其实是个非常糟糕的想法，非常不利于后期的维护，因此本人并没有去尝试修改RecyclerView
• 既然不想改动RecyclerView，那么就只能另寻他法了
• 是否可以在ViewPager2和RecyclerView中间再增加一层，来作为他们两之间事件的调解者呢
• 原理大概是中间这层如果已经知道RecyclerView滑到底部或顶部时就请求ViewPager2不要拦截事件(requestDisallowInterceptTouchEvent(true))，继续传递给子View，这样ViewPager2就没有收到事件不会触发tab切换，而子项的RecyclerView即使滑到底部了还是能继续处理上滑事件
• 示例代码如下

/**
 * 用于调解的中间view
 * 用于解决ViewPager2中使用RecyclerView时滑到底部再往上滑时会触发ViewPager2的横向滑动导致触发onPageSelected回调问题
 * 用法：作为可滚动View（如RecyclerView）的父布局，可滚动View为此父View的唯一子View
 */
class NestedScrollableMediateContainer @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : FrameLayout(context, attrs, defStyleAttr) {
    private var touchSlop = 0
    private var initialX = 0f
    private var initialY = 0f

    init {
        touchSlop = ViewConfiguration.get(context).scaledTouchSlop
    }

    override fun onInterceptTouchEvent(e: MotionEvent): Boolean {
        when (e.action) {
            MotionEvent.ACTION_DOWN -> {
                initialX = e.x
                initialY = e.y
            }
            MotionEvent.ACTION_MOVE -> {
                val dx = e.x - initialX
                val dy = e.y - initialY
                //如果是子view已经滚到底或滚到顶了
                if (!canScrollVertically(1) || !canScrollVertically(-1)) {
                    if (abs(dx) < abs(dy)) {
                        requestDisallowInterceptTouchEvent(true)
                    }
                }
            }
        }
        return super.onInterceptTouchEvent(e)
    }
}

• 最后提供一个通用的helper工具，可作用于任何ViewGroup

/**
 * 用以解决ViewPager2引起的滑动事件冲突的问题（比如viewpager2的RecyclerView在滑到底部再向上滑时会触发ViewPager2向右的事件，导致tab切换）
 * 用法示例：
 * step.1 private var helper: NestedScrollableMediateHelper = NestedScrollableMediateHelper(this)
 * step.2 override fun onInterceptTouchEvent(ev: MotionEvent): Boolean {
 * helper.onInterceptTouchEvent(ev)
 * return super.onInterceptTouchEvent(ev)
 * }
 */
class NestedScrollableMediateHelper(private val mHostView: ViewGroup) {
    private var mInitialX = 0f
    private var mInitialY = 0f

    fun onInterceptTouchEvent(e: MotionEvent) {
        when (e.action) {
            MotionEvent.ACTION_DOWN -> {
                mInitialX = e.x
                mInitialY = e.y
            }

            MotionEvent.ACTION_MOVE -> {
                val dx = e.x - mInitialX
                val dy = e.y - mInitialY
                //如果是子view已经滚到底或滚到顶了
                if (!mHostView.canScrollVertically(1) || !mHostView.canScrollVertically(-1)) {
                    if (Math.abs(dx) < Math.abs(dy)
                    ) {
                        mHostView.requestDisallowInterceptTouchEvent(true)
                    }
                }
            }
        }
    }
}

不在前台setCurrentItem无效问题

• 当进入后台后，在主线程设置ViewPager2.setCurrentItem竟然无效，只有处在前台时设置才有效
• 为使其在后台能生效，必须调用其对应的Adapter.notifyDataSetChanged()方法才行

参考

• (65条消息) 这可能是ViewPager2滑动冲突最全面的处理方案_Androidbye的博客-CSDN博客_viewpager2