如何在.NET MAUI中使用Handler自定义CollectionView实现末尾堆叠布局

MAUI 中 Android 平台的 CollectionView 底层原生控件为 RecyclerView，对应 Handler 为 CollectionViewHandler，你可以通过自定义 Handler 完全复现原 Xamarin.Forms Renderer 的效果，不需要依赖已废弃的 Renderer 兼容层。

方案1：针对特定列表生效（推荐，不影响全局其他CollectionView） #

• 第一步：在共享项目中定义自定义CollectionView类型

// 共享项目（可放在Controls目录下）
public class ChatCollectionView : CollectionView
{
}

• 第二步：在Android平台项目中编写自定义Handler，逻辑完全对应原Renderer实现

// Android平台项目下
using AndroidX.RecyclerView.Widget;
using Microsoft.Maui.Controls.Handlers.Items;

public class ChatCollectionViewHandler : CollectionViewHandler
{
    protected override RecyclerView CreatePlatformView()
    {
        var recycler = base.CreatePlatformView();
        // 对应原Renderer构造函数中的缓存、固定尺寸配置
        recycler.SetItemViewCacheSize(20);
        recycler.HasFixedSize = true;
        return recycler;
    }

    protected override void ConnectHandler(RecyclerView platformView)
    {
        base.ConnectHandler(platformView);
        // 对应原SelectLayoutManager方法的逻辑，替换布局管理器
        var layoutManager = new LinearLayoutManager(Context, LinearLayoutManager.Vertical, false)
        {
            StackFromEnd = true
        };
        platformView.SetLayoutManager(layoutManager);
    }
}

• 第三步：在MauiProgram.cs中注册Handler映射

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureMauiHandlers(handlers =>
    {
        // 关联自定义控件和自定义Handler
        handlers.AddHandler<ChatCollectionView, ChatCollectionViewHandler>();
    });

注册完成后，在XAML或C#代码中使用ChatCollectionView替代默认的CollectionView，即可实现列表项从控件末尾开始堆叠的效果，和原Xamarin.Forms实现表现完全一致。

方案2：全局生效（所有CollectionView默认启用末尾堆叠） #

如果不需要单独区分聊天列表和普通列表，可以直接修改全局CollectionView的Handler映射，无需自定义控件：

// MauiProgram.cs的ConfigureMauiHandlers中添加
handlers.AddHandler<CollectionView, CollectionViewHandler>(handler =>
{
    handler.Mapper.Add<CollectionView>((h, v) =>
    {
        var recycler = h.PlatformView;
        recycler.SetItemViewCacheSize(20);
        recycler.HasFixedSize = true;
        var layoutManager = new LinearLayoutManager(recycler.Context, LinearLayoutManager.Vertical, false)
        {
            StackFromEnd = true
        };
        recycler.SetLayoutManager(layoutManager);
    });
});

注意：如果你的列表是水平滚动场景，只需将LinearLayoutManager构造函数的第二个参数替换为LinearLayoutManager.Horizontal即可；不要将第三个反转布局参数设为true，StackFromEnd属性本身就会实现从末尾堆叠的效果，不会倒置列表的条目顺序，和你原有逻辑保持一致。

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