如何让Jetpack Compose HorizontalPager仅支持向前滑动（禁用向后滑动）

以下是两种可靠的实现方案，解决你遇到的手势检测和事件传递问题：

方案一：自定义手势拦截Modifier #

通过自定义Modifier检测水平拖动方向，仅允许向右（向前翻页）的滑动事件传递给HorizontalPager，拦截向左（向后翻页）的手势：

import androidx.compose.foundation.gestures.detectHorizontalDragGestures
import androidx.compose.ui.Modifier
import androidx.compose.ui.input.pointer.consume
import androidx.compose.ui.input.pointer.pointerInput
import androidx.compose.foundation.pager.PagerState

fun Modifier.onlyAllowForwardHorizontalScroll(pagerState: PagerState) = pointerInput(pagerState) {
    detectHorizontalDragGestures { change, dragAmount ->
        // 针对LTR布局：dragAmount < 0 表示向左拖动（试图回到上一页）
        // 若为RTL布局，将判断条件改为 dragAmount > 0 即可
        if (dragAmount < 0) {
            // 消耗该拖动事件，阻止HorizontalPager处理向后滑动
            change.consume()
        }
    }
}

使用方式： #

将该Modifier直接应用在HorizontalPager上，而非内部子控件：

HorizontalPager(
    state = pagerState,
    modifier = Modifier.onlyAllowForwardHorizontalScroll(pagerState)
) { page ->
    Box(
        modifier = Modifier.fillMaxSize().background(colors[page])
    ) {
        Text("Page $page")
    }
}

方案二：通过PagerState控制滚动行为 #

通过包装PagerState的ScrollableState，拦截向后滚动的请求：

import androidx.compose.foundation.pager.PagerState
import androidx.compose.foundation.ScrollableState
import androidx.compose.foundation.gestures.ScrollPriority
import androidx.compose.foundation.gestures.ScrollScope

val pagerState = rememberPagerState()
val restrictedScrollableState = remember {
    object : ScrollableState by pagerState.scrollableState {
        override suspend fun performScroll(
            scrollPriority: ScrollPriority,
            block: suspend (ScrollScope) -> Float
        ): Float {
            // 若尝试滚动到当前页之前的页面，直接拦截
            val targetPage = pagerState.targetPage
            val currentPage = pagerState.currentPage
            if (targetPage < currentPage) {
                return 0f
            }
            return super.performScroll(scrollPriority, block)
        }
    }
}

使用方式： #

注意：此方案需使用HorizontalPager的重载构造函数，传入自定义的scrollableState：

HorizontalPager(
    state = pagerState,
    scrollableState = restrictedScrollableState
) { page ->
    // 页面内容
}

为何你的原有方案失效？ #

• 将pointerInput加在内部Box上：子控件的手势检测会优先消耗事件，导致HorizontalPager无法接收滑动事件，自然无法滚动。
• 将pointerInput加在HorizontalPager上：HorizontalPager内部的滚动手势处理优先级更高，自定义的检测逻辑无法获取到事件。
• 使用pointerInteropFilter：该API为底层互操作接口，HorizontalPager内部的手势系统已经处理了水平滚动的ACTION_MOVE事件，因此你无法捕获到对应回调。

内容的提问来源于stack exchange，提问作者Fred