Android ViewPager2横向轮播首尾项偏移调整及平滑动画实现问题

嗨，我明白你现在的需求——想让ViewPager2轮播的首尾项在选中时分别向左、向右偏移指定距离，同时保证滑动动画平滑不生硬对吧？之前你尝试通过索引判断但动画卡壳，其实核心问题是要结合ViewPager2自带的position参数（滑动时的连续变化值）来做渐变调整，而不是生硬切换偏移量。我给你整理一套可行的实现方案：

第一步：先配置ViewPager2基础属性 #

首先要让ViewPager2允许内容超出边缘显示，不然首尾项的偏移会被裁剪掉，在初始化ViewPager2的时候加上：

// 这里的padding要和你后面Transformer里用的padding保持一致
val padding = resources.getDimension(R.dimen.carousel_padding)
viewPager2.apply {
    clipToPadding = false
    setPadding(padding.toInt(), 0, padding.toInt(), 0)
    offscreenPageLimit = 1 // 预加载前后一页，保证滑动流畅
}

第二步：自定义PageTransformer实现首尾偏移+平滑动画 #

我们需要在Transformer里拿到当前item的索引和总item数，结合position参数做动态调整。直接上代码，我会给你逐行解释：

class CarouselPageTransformer(
    private val padding: Float,
    private val viewPager2: ViewPager2
) : ViewPager2.PageTransformer {

    override fun transformPage(view: View, position: Float) {
        val adapter = viewPager2.adapter ?: return
        val itemCount = adapter.itemCount
        val itemIndex = viewPager2.getChildAdapterPosition(view)
        
        // 过滤无效索引和只有单个item的情况
        if (itemIndex == RecyclerView.NO_POSITION || itemCount <= 1) {
            return
        }

        // 沿用你原来的offset计算逻辑，这部分不用改
        val cardWidthPlusPaddings = view.width + padding * 2F
        val desiredCardWidthPlusPaddings = cardWidthPlusPaddings + padding
        val cardScale: Float = cardWidthPlusPaddings / desiredCardWidthPlusPaddings

        val currentCardWidth = cardWidthPlusPaddings * cardScale
        val offset = ((cardWidthPlusPaddings - currentCardWidth) / 2) - padding

        // 基础translationX计算（和你原来的逻辑一致）
        var translationX = position * -(2 * padding + offset)

        // 处理首尾项的特殊偏移
        when (itemIndex) {
            0 -> {
                // 第一个item：选中时左移offset，滑动时平滑过渡到正常位置
                // 用position的绝对值计算过渡系数，保证动画连续
                val transitionFactor = Math.max(0F, 1 - Math.abs(position))
                val offsetAdjustment = offset * transitionFactor
                translationX -= offsetAdjustment
            }
            itemCount - 1 -> {
                // 最后一个item：选中时右移offset，滑动时平滑过渡到正常位置
                val transitionFactor = Math.max(0F, 1 - Math.abs(position))
                val offsetAdjustment = offset * transitionFactor
                translationX += offsetAdjustment
            }
        }

        // 如果你暂时不想处理左右卡片的缩放，可以注释掉下面两行
        val scaleFactor = if (position in -1F..1F) 1 - (1 - cardScale) * Math.abs(position) else cardScale
        view.scaleX = scaleFactor
        view.scaleY = scaleFactor

        view.translationX = translationX
    }
}

关键逻辑解释 #

1. 过渡系数的作用：Math.max(0F, 1 - Math.abs(position))这个值会随着滑动从1平滑降到0——当item处于选中状态（position=0）时，系数是1，偏移量完全生效；当item滑出屏幕边缘（position=±1）时，系数是0，偏移量完全取消，这样就实现了滑动过程中偏移量的平滑过渡，不会出现跳变。
2. 首尾项的判断：通过itemIndex判断当前是第一个还是最后一个item，只对这两个item做额外偏移调整，中间项保持原来的逻辑即可。
3. 保留原有缩放逻辑：你提到暂时可以先忽略左右卡片的缩放，所以我把缩放代码做了标注，需要的时候打开就行，不影响偏移功能。

最后把Transformer设置给ViewPager2 #

viewPager2.setPageTransformer(CarouselPageTransformer(padding, viewPager2))

这样就能实现你要的效果：选中第一个item时它会向左偏移指定距离，选中最后一个时向右偏移，滑动过程中动画完全平滑，不会有生硬的跳转~

备注：内容来源于stack exchange，提问作者Mark D