如何在.NET MAUI Android平台TabBar中移除或隐藏标签文本

当你将TabBar的标题留空时，Android端的BottomNavigationView仍会保留标题的占位空间，导致图标无法填满TabBar区域。可以通过以下两种方式解决：

方法一：使用MAUI Handler（推荐方案） #

MAUI推荐使用Handler而非传统渲染器来定制原生控件，步骤如下：

1. 在项目的Platforms/Android目录下创建CustomTabBarHandler.cs文件，代码如下：

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

namespace YourAppName.Platforms.Android;

public class CustomTabBarHandler : TabBarHandler
{
    protected override void ConnectHandler(BottomNavigationView platformView)
    {
        base.ConnectHandler(platformView);
        
        // 隐藏所有菜单项的标签
        platformView.LabelVisibilityMode = BottomNavigationView.LabelVisibilityModeUnlabeled;
        
        // 清空标题文本，彻底移除占位
        for (int i = 0; i < platformView.Menu.Size(); i++)
        {
            platformView.Menu.GetItem(i).SetTitle("");
        }
        
        // 可选：调整图标大小，让图标占据更多空间
        platformView.ItemIconSize = Android.Util.TypedValue.ApplyDimension(
            Android.Util.ComplexUnitType.Dip, 
            32, 
            Context.Resources.DisplayMetrics);
    }
}

2. 在MauiProgram.cs中注册自定义Handler：

builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    handlers.AddHandler<Microsoft.Maui.Controls.TabBar, YourAppName.Platforms.Android.CustomTabBarHandler>();
#endif
});

方法二：使用自定义渲染器（兼容旧版MAUI） #

如果项目仍依赖传统渲染器模式，可以使用以下代码：

1. 在Platforms/Android目录下创建CustomTabBarRenderer.cs文件：

using Android.Content;
using Microsoft.Maui.Controls.Platform;
using Microsoft.Maui.Controls;
using AndroidX.AppCompat.Widget;

[assembly: ExportRenderer(typeof(TabBar), typeof(YourAppName.Platforms.Android.CustomTabBarRenderer))]
namespace YourAppName.Platforms.Android;

public class CustomTabBarRenderer : TabBarRenderer
{
    public CustomTabBarRenderer(Context context) : base(context)
    {
    }

    protected override void OnElementChanged(ElementChangedEventArgs<TabBar> e)
    {
        base.OnElementChanged(e);
        
        if (Control is BottomNavigationView bottomNav)
        {
            // 隐藏标签文本，移除占位
            bottomNav.LabelVisibilityMode = BottomNavigationView.LabelVisibilityModeUnlabeled;
            
            // 清空所有菜单项的标题
            for (int i = 0; i < bottomNav.Menu.Size(); i++)
            {
                bottomNav.Menu.GetItem(i).SetTitle("");
            }
            
            // 可选：调整图标大小
            bottomNav.ItemIconSize = Android.Util.TypedValue.ApplyDimension(
                Android.Util.ComplexUnitType.Dip, 
                32, 
                Context.Resources.DisplayMetrics);
        }
    }
}

效果说明 #

上述两种方法都会彻底移除TabBar标签的占位空间，让图标可以填充TabBar的垂直区域，解决留空标题后仍有空白的问题。

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