UIScrollView开启pagingEnabled时修改targetContentOffset无效求助

当pagingEnabled=YES时，你修改targetContentOffset无效的核心原因是：UIScrollView内部会在scrollViewWillEndDragging代理方法执行完成后，自动调用私有逻辑重新计算目标偏移量，强制遵循50%阈值的分页规则，直接覆盖你设置的targetContentOffset。

简单来说，你的代码先设置了目标偏移，但系统紧接着又把它改回了默认的分页逻辑结果，所以看起来没生效。

解决方案：临时关闭分页逻辑，设置偏移后恢复 #

要在保留pagingEnabled=YES的其他交互（比如页面吸附、边界限制）的同时，实现"只要有滚动就翻页"的逻辑，我们可以临时关闭pagingEnabled，让系统不执行默认的分页偏移覆盖，设置完自定义偏移后再恢复分页状态。

Objective-C 代码示例 #

- (void)scrollViewWillEndDragging:(UIScrollView *)scrollView withVelocity:(CGPoint)velocity targetContentOffset:(inout CGPoint *)targetContentOffset {
    CGFloat pageWidth = scrollView.frame.size.width;
    NSInteger currentPage = scrollView.contentOffset.x / pageWidth;
    NSInteger targetPage = currentPage;

    // 根据拖动方向和位移判断目标页：只要有明显滚动就切换
    if (velocity.x > 0 || (velocity.x == 0 && targetContentOffset->x > scrollView.contentOffset.x + pageWidth * 0.01)) {
        targetPage = currentPage + 1;
    } else if (velocity.x < 0 || (velocity.x == 0 && targetContentOffset->x < scrollView.contentOffset.x - pageWidth * 0.01)) {
        targetPage = currentPage - 1;
    }

    // 限制页面范围，避免越界
    targetPage = MAX(0, MIN(targetPage, (NSInteger)(scrollView.contentSize.x / pageWidth) - 1));

    // 临时关闭分页，绕过系统的默认偏移覆盖逻辑
    scrollView.pagingEnabled = NO;
    targetContentOffset->x = targetPage * pageWidth;

    // 在下一个主队列循环恢复分页，保留原有交互体验
    dispatch_async(dispatch_get_main_queue(), ^{
        scrollView.pagingEnabled = YES;
    });
}

Swift 代码示例 #

func scrollViewWillEndDragging(_ scrollView: UIScrollView, withVelocity velocity: CGPoint, targetContentOffset: UnsafeMutablePointer<CGPoint>) {
    let pageWidth = scrollView.frame.width
    let currentPage = Int(scrollView.contentOffset.x / pageWidth)
    var targetPage = currentPage

    // 判断滚动方向与位移，只要有有效滚动就切换页面
    if velocity.x > 0 || (velocity.x == 0 && targetContentOffset.pointee.x > scrollView.contentOffset.x + pageWidth * 0.01) {
        targetPage = currentPage + 1
    } else if velocity.x < 0 || (velocity.x == 0 && targetContentOffset.pointee.x < scrollView.contentOffset.x - pageWidth * 0.01) {
        targetPage = currentPage - 1
    }

    // 防止页面越界
    targetPage = max(0, min(targetPage, Int(scrollView.contentSize.x / pageWidth) - 1))

    // 临时关闭分页，让自定义偏移生效
    scrollView.isPagingEnabled = false
    targetContentOffset.pointee.x = CGFloat(targetPage) * pageWidth

    // 恢复分页状态，保留原有交互
    DispatchQueue.main.async {
        scrollView.isPagingEnabled = true
    }
}

关键细节说明 #

1. 微小位移阈值：用pageWidth * 0.01作为判断阈值，是为了避免手指轻微抖动导致的误翻页，同时确保只要有实际的滚动意图就触发翻页。
2. 页面越界保护：必须限制targetPage的范围，否则会导致滚动视图滚到超出内容尺寸的位置，出现空白或异常。
3. 恢复时机：用dispatch_async在下一个主队列循环恢复pagingEnabled，是为了让系统先处理我们设置的偏移量，再恢复分页逻辑，避免冲突。

这种方法既实现了你想要的自定义翻页规则，又完整保留了pagingEnabled=YES带来的其他友好交互，比如滚动时的页面吸附、边界无法滚动的限制等。

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