如何在MAUI中为Android工具栏添加监听以拦截返回/汉堡图标点击

核心问题分析 #

你之前在NavigationViewHandler的CreatePlatformView中直接查找Toolbar返回null，是因为此时视图还未完成布局，Toolbar尚未被添加到视图树中。MAUI中NavigationPage对应的Android平台Handler是NavigationPageHandler，需等待布局完成后再获取Toolbar并绑定事件。

具体实现步骤 #

1. 创建自定义NavigationPageHandler（Android项目内）

using Android.Views;
using AndroidX.AppCompat.Widget;
using Microsoft.Maui.Handlers;

namespace YourAppNamespace.Platforms.Android;

public class CustomNavigationPageHandler : NavigationPageHandler
{
    private Toolbar _toolbar;

    protected override void OnElementChanged(ElementChangedEventArgs<Microsoft.Maui.Controls.NavigationPage> args)
    {
        base.OnElementChanged(args);

        if (PlatformView != null)
        {
            // 监听布局变化，确保Toolbar已初始化完成
            PlatformView.LayoutChange += OnLayoutChange;
        }

        // 清理旧元素的事件绑定
        if (args.OldElement != null)
        {
            _toolbar?.NavigationClick -= OnNavigationClick;
            PlatformView.LayoutChange -= OnLayoutChange;
            _toolbar = null;
        }
    }

    private void OnLayoutChange(object sender, View.LayoutChangeEventArgs e)
    {
        if (_toolbar == null)
        {
            // MAUI中Toolbar的固定ID为Resource.Id.toolbar
            _toolbar = PlatformView.FindViewById<Toolbar>(Resource.Id.toolbar);
            if (_toolbar != null)
            {
                _toolbar.NavigationClick += OnNavigationClick;
                // 找到Toolbar后取消布局监听，避免重复执行
                PlatformView.LayoutChange -= OnLayoutChange;
            }
        }
    }

    private void OnNavigationClick(object sender, View.NavigationClickEventArgs e)
    {
        // 拦截默认行为（如需保留默认逻辑可删除此行）
        e.Handled = true;
        
        // 此处添加你的自定义处理逻辑
        // 示例：弹窗提示或自定义页面跳转
        // Toast.MakeText(PlatformView.Context, "导航图标被点击", ToastLength.Short).Show();
    }

    protected override void Dispose(bool disposing)
    {
        // 销毁时清理事件绑定，避免内存泄漏
        if (disposing)
        {
            _toolbar?.NavigationClick -= OnNavigationClick;
            PlatformView?.LayoutChange -= OnLayoutChange;
            _toolbar = null;
        }
        base.Dispose(disposing);
    }
}

2. 注册自定义Handler（MauiProgram.cs）

using YourAppNamespace.Platforms.Android;

namespace YourAppNamespace;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
            });

        // 仅在Android平台注册自定义Handler
#if ANDROID
        builder.ConfigureMauiHandlers(handlers =>
        {
            handlers.AddHandler(typeof(Microsoft.Maui.Controls.NavigationPage), typeof(CustomNavigationPageHandler));
        });
#endif

        return builder.Build();
    }
}

额外说明 #

• 若需区分点击的是返回箭头还是汉堡图标，可通过_toolbar.NavigationIcon的属性判断，或结合当前页面在导航栈中的层级（根页面显示汉堡图标，子页面显示返回箭头）。
• 务必在Dispose方法中移除事件绑定，避免内存泄漏问题。

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