Android ViewPager.PageTransformer详解

PageTransformer是ViewPager内部定义的接口，实现该接口并应用于ViewPager可以控制ViewPager中item view的滑动效果。先上一张示例图





接下来我们看一下PageTransformer源码及api介绍，比较简单


        /**
         * A PageTransformer is invoked whenever a visible/attached page is scrolled.
         * This offers an opportunity for the application to apply a custom transformation
         * to the page views using animation properties.
         *
         * <p>As property animation is only supported as of Android 3.0 and forward,
         * setting a PageTransformer on a ViewPager on earlier platform versions will
         * be ignored.</p>
         */
        public interface PageTransformer {
            /**
             * Apply a property transformation to the given page.
             *
             * @param page Apply the transformation to this page
             * @param position Position of page relative to the current front-and-center
             *                 position of the pager. 0 is front and center. 1 is one full
             *                 page position to the right, and -1 is one page position to the left.
             */
            void transformPage(@NonNull View page, float position);
        }


简单看一下接口描述，直白的翻译过来，大致意思是：当附着于ViewPager中的页面滑动时，会触发PageTransformer 实例（transformPage方法）。PageTransformer 支持用户通过动画属性自定义页面滑动效果。


PageTransformer只有一个方法： transformPage(@NonNull View page, float position)。该方法的api描述，我想多数人都没有搞清楚，尤其是对position参数理解，下面就着重讲解一下该方法及参数。
在讲解参数前，我们先定义两个描述语：基准参考点、page页面间距归一化


 ######基准参考点
基准参考点，是指ViewPager处于(最近一次处于)SCROLL_STATE_IDLE状态(此状态下cureent page完整显示，没有滑动偏移。备注：若处于滑动过程，则取最近一次处于SCROLL_STATE_IDLE状态)时cureent page的position值，为0。 transformPage方法中的position都是相对于这个基准参考点的相对值。以基准参考点为中心，建立一维坐标，左侧为负，右侧为正，来描述page的position值。
 ######page页面宽度归一化
这个归一化是指，将page物理宽度归一化为1，以此为基础进行page相对于基准参考点的position值计算


根据以上两个描述语的定义，显然相邻page间距是1。下面贴上SCROLL_STATE_IDLE状态下示意图：


接下来讲解参数：
参数page是ViewPager持有的页面(包括cureent page)的rootView，position是page相对于基准参考点的偏移量，滑动过程中可标识page的偏移程度，周期为1。根据基准参考点及page页面宽度归一化的描述，在SCROLL_STATE_IDLE状态下，current page的position为0，上一页的position为-1.0，下一页的position为1.0，依此类推。position随ViewaPger滑动趋势发生相应变化：
向左滑动时，page相对于基准参考点向左偏移，position减小；向右滑动时page相对于基准参考点向右偏移，position变大，示意图如下

有了以上说明，我们就可以利用transformPage(@NonNull View page, float position)方法操控page滑动效果了。根据page参数，可以拿到page的真实物理宽度与高度，根据position计算动效的参数值。下面贴出具有层叠效果的PageTransformer实例代码：


    public class HorizontalStackTransformerWithRotation implements ViewPager.PageTransformer {
        private static final float CENTER_PAGE_SCALE = 0.8f;
        private int offscreenPageLimit;
        private ViewPager boundViewPager;


        public HorizontalStackTransformerWithRotation(@NonNull ViewPager boundViewPager) {
            this.boundViewPager = boundViewPager;
            this.offscreenPageLimit = boundViewPager.getOffscreenPageLimit();
        }


        @Override
        public void transformPage(@NonNull View view, float position) {
            int pagerWidth = boundViewPager.getWidth();
            float horizontalOffsetBase = (pagerWidth - pagerWidth * CENTER_PAGE_SCALE) / 2 / offscreenPageLimit + DisplayUtil.dp2px(15);


            if (position >= offscreenPageLimit || position <= -1) {
                view.setVisibility(View.GONE);
            } else {
                view.setVisibility(View.VISIBLE);
            }


            if (position >= 0) {
                float translationX = (horizontalOffsetBase - view.getWidth()) * position;
                view.setTranslationX(translationX);
            }
            if (position > -1 && position < 0) {
                float rotation = position * 30;
                view.setRotation(rotation);
                view.setAlpha((position * position * position + 1));
            } else if (position > offscreenPageLimit - 1) {
                view.setAlpha((float) (1 - position + Math.floor(position)));
            } else {
                view.setRotation(0);
                view.setAlpha(1);
            }
            if (position == 0) {
                view.setScaleX(CENTER_PAGE_SCALE);
                view.setScaleY(CENTER_PAGE_SCALE);
            } else {
                float scaleFactor = Math.min(CENTER_PAGE_SCALE - position * 0.1f, CENTER_PAGE_SCALE);
                view.setScaleX(scaleFactor);
                view.setScaleY(scaleFactor);
            }


            // test code: view初始化时，设置了tag
            String tag = (String) view.getTag();
    //        LogUtil.e("viewTag" + tag, "viewTag: " + (String) view.getTag() + " --- transformerPosition: " + position + " --- floor: " + Math.floor(position) + " --- childCount: "+ boundViewPager.getChildCount());
            ViewCompat.setElevation(view, (offscreenPageLimit - position) * 5);
        }
    }
为了加深理解，您可以在初始化item view的时候，为其设置一个tag，tag值可设为item在列表中的index，并输出日志观察transformPage(View view, float position)方法中position变化情况
完整示例：https://github.com/670832188/TestApp