如何处理MAUI Handler中自定义控件的属性变更问题

问题根源 #

当前映射代码仅在控件初始化阶段执行一次，未监听自定义属性的变更事件，导致属性值更新后平台视图无法同步刷新。

修复步骤 #

1. 调整Handler注册逻辑 #

改用EntryHandler的Mapper扩展（而非ElementHandler），因为CustomEntry继承自Entry，对应平台Handler为EntryHandler：

// 替换原注册代码
Microsoft.Maui.Handlers.EntryHandler.Mapper.AppendToMapping(nameof(CustomEntry), (handler, view) =>
{
    if (view is CustomEntry customEntry)
    {
        // 初始化时批量应用所有自定义属性
        UpdateCustomEntryAppearance(handler, customEntry);
    }
});

// 为每个自定义属性单独注册映射，监听属性变更
Microsoft.Maui.Handlers.EntryHandler.Mapper.Add(nameof(CustomEntry.BorderColor), (handler, view) =>
{
    if (view is CustomEntry customEntry) UpdateBorderAppearance(handler, customEntry);
});

Microsoft.Maui.Handlers.EntryHandler.Mapper.Add(nameof(CustomEntry.CornerRadius), (handler, view) =>
{
    if (view is CustomEntry customEntry) UpdateBorderAppearance(handler, customEntry);
});

Microsoft.Maui.Handlers.EntryHandler.Mapper.Add(nameof(CustomEntry.BorderThickness), (handler, view) =>
{
    if (view is CustomEntry customEntry) UpdateBorderAppearance(handler, customEntry);
});

Microsoft.Maui.Handlers.EntryHandler.Mapper.Add(nameof(CustomEntry.BackgroundColor), (handler, view) =>
{
    if (view is CustomEntry customEntry) UpdateBorderAppearance(handler, customEntry);
});

Microsoft.Maui.Handlers.EntryHandler.Mapper.Add(nameof(CustomEntry.Padding), (handler, view) =>
{
    if (view is CustomEntry customEntry) UpdatePadding(handler, customEntry);
});

2. 拆分映射逻辑为可复用方法 #

将原映射代码拆分为独立方法，方便属性变更时单独或批量调用：

private static void UpdateCustomEntryAppearance(EntryHandler handler, CustomEntry customEntry)
{
    UpdateBorderAppearance(handler, customEntry);
    UpdatePadding(handler, customEntry);
    // 若需处理PlaceholderFontSize，可在此添加对应更新方法
}

private static void UpdateBorderAppearance(EntryHandler handler, CustomEntry customEntry)
{
    if (handler.PlatformView == null || handler.MauiContext == null) return;

    var gd = new GradientDrawable();
    gd.SetColor(customEntry.BackgroundColor.ToAndroid());
    gd.SetCornerRadius((int)handler.MauiContext.Context.ToPixels(customEntry.CornerRadius));
    gd.SetStroke(
        (int)handler.MauiContext.Context.ToPixels(customEntry.BorderThickness), 
        customEntry.BorderColor.ToAndroid()
    );
    
    handler.PlatformView.SetBackground(gd);
}

private static void UpdatePadding(EntryHandler handler, CustomEntry customEntry)
{
    if (handler.PlatformView == null || handler.MauiContext == null) return;

    var padTop = (int)handler.MauiContext.Context.ToPixels(customEntry.Padding.Top);
    var padBottom = (int)handler.MauiContext.Context.ToPixels(customEntry.Padding.Bottom);
    var padLeft = (int)handler.MauiContext.Context.ToPixels(customEntry.Padding.Left);
    var padRight = (int)handler.MauiContext.Context.ToPixels(customEntry.Padding.Right);

    handler.PlatformView.SetPadding(padLeft, padTop, padRight, padBottom);
}

3. （可选）增强自定义属性的变更回调 #

在自定义BindableProperty定义中添加propertyChanged回调，作为双重保障：

以BorderColorProperty为例：

public static readonly BindableProperty BorderColorProperty =
    BindableProperty.Create(
        nameof(BorderColor), 
        typeof(Color), 
        typeof(CustomEntry), 
        Colors.Transparent,
        propertyChanged: (bindable, oldValue, newValue) =>
        {
            if (bindable is CustomEntry entry && entry.Handler is EntryHandler handler)
            {
                UpdateBorderAppearance(handler, entry);
            }
        });

核心原理 #

MAUI的Handler Mapper系统会自动监听BindableProperty的变更，当属性值改变时，会触发对应属性名的映射方法。通过为每个自定义属性单独注册映射逻辑，即可实现属性变更时自动同步更新平台视图。

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