使用.NET MAUI Handler时Android平台按钮不可见的问题

问题概述 #

自定义IconButton（继承自Button）并创建对应Handler后，Android平台按钮完全不可见；注释Handler注册代码后按钮恢复显示。即使仅保留CreatePlatformView的空逻辑，问题依然存在。

代码问题分析 #

1. BindableProperty定义错误 #

IconButton的HorizontalContentAlignmentProperty创建时，属性名称参数错误：

// 错误：属性名称应为nameof(HorizontalContentAlignment)，而非nameof(IconButton)
public static readonly BindableProperty HorizontalContentAlignmentProperty = BindableProperty.Create(
    nameof(IconButton),        // 此处错误
    typeof(TextAlignment),
    typeof(IconButton),
    TextAlignment.Center);

该错误会导致属性无法正确绑定，虽不是按钮消失的直接原因，但必须修复。

2. Handler未继承Button的原有属性映射 #

共享平台分部类的PropertyMapper基于ViewHandler.ViewMapper，而非ButtonHandler.PropertyMapper，导致Button核心属性（如Text、BackgroundColor、WidthRequest等）未被映射到Android平台视图，最终平台按钮因缺少必要属性（如文本、尺寸）而不可见。

3. Android Handler未复用ButtonHandler逻辑 #

直接继承ViewHandler<IconButton, AppCompatButton>而非ButtonHandler，需手动实现所有Button属性的映射逻辑，否则平台视图无法同步IconButton的XAML配置。

修复后的代码 #

1. 修复IconButton的BindableProperty #

public TextAlignment HorizontalContentAlignment
{
    get => (TextAlignment)GetValue(HorizontalContentAlignmentProperty);
    set => SetValue(HorizontalContentAlignmentProperty, value);
}

public static readonly BindableProperty HorizontalContentAlignmentProperty = BindableProperty.Create(
    nameof(HorizontalContentAlignment),  // 修正属性名称
    typeof(TextAlignment),
    typeof(IconButton),
    TextAlignment.Center);

2. 共享平台分部类（基于ButtonHandler的Mapper） #

public partial class IconButtonHandler : ButtonHandler
{
    public static new IPropertyMapper<IconButton, IconButtonHandler> PropertyMapper = 
        new PropertyMapper<IconButton, IconButtonHandler>(ButtonHandler.PropertyMapper)
        {
            [nameof(IconButton.HorizontalContentAlignment)] = MapHorizontalAlignment
        };

    public IconButtonHandler() : base(PropertyMapper)
    {
    }

    public IconButtonHandler(IPropertyMapper mapper, CommandMapper commandMapper = null) 
        : base(mapper, commandMapper)
    {
    }
}

3. Android平台分部类（复用ButtonHandler逻辑） #

public partial class IconButtonHandler
{
    public static void MapHorizontalAlignment(IconButtonHandler handler, IconButton view)
    {
        if (handler.PlatformView is AppCompatButton button)
        {
            button.Gravity = view.HorizontalContentAlignment.ToDroidHorizontalGravity();
        }
    }
}

说明：继承ButtonHandler后，无需重写CreatePlatformView、ConnectHandler、DisconnectHandler，因为ButtonHandler已实现这些核心逻辑，只需添加自定义属性的映射方法即可。

4. MauiProgram.cs中的Handler注册（保持不变） #

.ConfigureMauiHandlers(handlers =>
{ 
    handlers.AddHandler(typeof(IconButton), typeof(IconButtonHandler));
})

核心修复点说明 #

• 复用ButtonHandler现有逻辑，避免从零实现所有Button属性的平台映射，确保按钮基础样式、文本、布局参数正常同步。
• 基于ButtonHandler.PropertyMapper扩展自定义属性映射，保留Button原有属性的映射规则。
• 修正BindableProperty名称错误，确保属性绑定正常工作。

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