Jetpack Compose中基于HorizontalPager实现循环/无限列表的方法

完全可以用Accompanist的HorizontalPager实现无限循环滚动，不用重复列表，核心思路是通过大数页数+索引映射模拟无限效果，具体方法如下：

核心逻辑 #

用Int.MAX_VALUE作为Pager的总页数，再通过取模运算将当前页索引映射到真实数据源索引。由于Int.MAX_VALUE数值极大，用户几乎不可能滚动到边界，视觉上就实现了无限循环。

具体实现代码 #

import androidx.compose.foundation.background
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.text.font.FontSize
import androidx.compose.ui.unit.dp
import com.google.accompanist.pager.HorizontalPager
import com.google.accompanist.pager.rememberPagerState

@Composable
fun InfiniteHorizontalPager() {
    // 你的真实数据源
    val realItems = listOf("首页", "列表页", "详情页", "设置页")
    
    // 初始页设为大数中间值，避免用户初始往回滚触达边界
    val pagerState = rememberPagerState(initialPage = Int.MAX_VALUE / 2)

    HorizontalPager(
        count = Int.MAX_VALUE,
        state = pagerState,
        pageSpacing = 12.dp,
        contentPadding = PaddingValues(horizontal = 16.dp),
        // 禁用边界渐变效果，让循环更自然
        beyondBoundsPageCount = 0
    ) { currentPage ->
        // 计算真实数据源的索引，处理反向滚动时的负数情况
        val realIndex = (currentPage % realItems.size + realItems.size) % realItems.size
        
        // 渲染你的页面内容
        Box(
            modifier = Modifier
                .fillMaxSize()
                .padding(8.dp)
                .background(Color.LightGray),
            contentAlignment = Alignment.Center
        ) {
            Text(
                text = realItems[realIndex],
                fontSize = FontSize(24.sp)
            )
        }
    }
}

关键细节说明 #

• 大数页数：用Int.MAX_VALUE作为总页数，彻底解决重复列表会走到头的问题，用户正常滚动几乎不可能触达边界
• 初始页位置：设为Int.MAX_VALUE / 2，给用户前后滚动留足空间，避免初始状态下反向滚动就触达边界
• 索引映射：(currentPage % realItems.size + realItems.size) % realItems.size能处理所有滚动方向的索引计算，包括反向滚动时的负数情况
• 边界效果禁用：设置beyondBoundsPageCount = 0关闭Pager默认的边界渐变，让循环滚动的视觉效果更连贯

内容的提问来源于stack exchange，提问作者Filipe Gonçalves