求助：Xamarin.Forms中CarouselPage iOS端过度滑动显示空白页问题

我之前做Xamarin.Forms项目时也碰到过一模一样的问题——iOS端CarouselPage滑到首尾页后还能继续滑动，露出讨厌的空白，Android却完全正常，而且直接禁用滑动手势的话连切换动画都没了，太影响体验！下面是我亲测有效的解决方案，核心是通过自定义iOS渲染器来限制过度滑动，同时保留原生的页面切换动画：

步骤1：创建自定义CarouselPage子类 #

先在共享项目里定义一个继承自CarouselPage的子类，方便后续渲染器识别：

using Xamarin.Forms;

namespace YourAppNamespace
{
    public class LimitedSwipeCarouselPage : CarouselPage
    {
        // 不需要额外代码，只是作为标记类
    }
}

之后把你原来的CarouselPage替换成这个LimitedSwipeCarouselPage即可。

步骤2：实现iOS自定义渲染器 #

在iOS项目中添加一个渲染器类，继承自CarouselPageRenderer，并实现UIScrollViewDelegate来拦截滚动行为：

using System;
using UIKit;
using Xamarin.Forms;
using Xamarin.Forms.Platform.iOS;
using YourAppNamespace;
using YourAppNamespace.iOS.Renderers;

[assembly: ExportRenderer(typeof(LimitedSwipeCarouselPage), typeof(LimitedSwipeCarouselPageRenderer))]
namespace YourAppNamespace.iOS.Renderers
{
    public class LimitedSwipeCarouselPageRenderer : CarouselPageRenderer, IUIScrollViewDelegate
    {
        private UIPageViewController _pageViewController;
        private UIScrollView _scrollView;

        public override void ViewDidLoad()
        {
            base.ViewDidLoad();
            
            // 获取底层的UIPageViewController
            _pageViewController = (UIPageViewController)ViewControllers[0];
            // 找到UIPageViewController内部的UIScrollView
            foreach (var view in _pageViewController.View.Subviews)
            {
                if (view is UIScrollView scrollView)
                {
                    _scrollView = scrollView;
                    _scrollView.Delegate = this;
                    break;
                }
            }
        }

        // 重写滚动结束拖拽的方法，限制过度滑动
        [Export("scrollViewWillEndDragging:withVelocity:targetContentOffset:")]
        public void ScrollViewWillEndDragging(UIScrollView scrollView, CoreGraphics.CGPoint velocity, ref CoreGraphics.CGPoint targetContentOffset)
        {
            var carouselPage = (LimitedSwipeCarouselPage)Element;
            if (carouselPage == null || carouselPage.Children.Count <= 1)
                return;

            // 计算当前页面索引
            var currentIndex = carouselPage.Children.IndexOf(carouselPage.CurrentPage);
            // 页面宽度
            var pageWidth = scrollView.Frame.Width;

            // 当在第一页且向左滑（velocity.x为负），阻止滑动
            if (currentIndex == 0 && velocity.X < 0)
            {
                targetContentOffset = new CoreGraphics.CGPoint(0, 0);
            }
            // 当在最后一页且向右滑（velocity.x为正），阻止滑动
            else if (currentIndex == carouselPage.Children.Count - 1 && velocity.X > 0)
            {
                targetContentOffset = new CoreGraphics.CGPoint(pageWidth * (carouselPage.Children.Count - 1), 0);
            }
        }
    }
}

原理说明 #

这个方案的核心是：

• 找到CarouselPage底层的UIScrollView（iOS的UIPageViewController是靠UIScrollView实现分页滑动的）
• 通过ScrollViewWillEndDragging方法拦截滚动的目标位置，当用户试图从第一页向左滑、或从最后一页向右滑时，强制把滚动目标设置为当前页面的位置，既不会出现空白，又完全保留了原生的页面切换动画。

亲测这个方法在iOS上完美解决了过度滑动空白的问题，而且页面切换的流畅度和原来一模一样，Android端也不受任何影响~

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