在 .NET MAUI 中,Shell 的 TabBar 默认支持底部显示(尤其在 Android 和 Windows 上),但原生行为和样式控制需配合平台特性与 Shell 属性协同调整。自定义底部标签栏不是单纯改颜色,而是围绕位置、背景、图标文字、居中逻辑、平台适配这五个关键点展开。
一、确保 TabBar 显示在底部
基础配置必须显式设置
Shell.TabBarPlacement="Bottom",否则 Windows 和 macOS 可能默认顶部显示: 在
AppShell.xaml的根
<shell></shell>内直接设置:
<shell tabbarplacement="Bottom">...</shell>Windows 平台若仍显示异常,可在
Platforms/Windows/App.xaml.cs的
OnLaunched中补一句强制刷新(非必需但稳妥):
Microsoft.Maui.Handlers.ShellHandler.Mapper.ModifyMapping(nameof(Shell.TabBarPlacement), ...);iOS 需注意安全区域,底部 TabBar 会自动避开 Home Indicator,无需额外偏移
二、统一控制颜色与字体大小
通过
Shell的附加属性或资源字典批量设置,避免逐项写死: 背景色:
Shell.BackgroundColor控制整个 TabBar 区域(含未选中项背景) 文字颜色:
Shell.UnselectedColor(未选中)、
Shell.SelectedColor(选中) 图标+文字尺寸:
Shell.TabBarItemIconSize和
Shell.TabBarItemFontSize支持
OnPlatform适配,例如:
Value="{OnPlatform iOS=22, Android=28, Windows=24}"
标题是否显示:Shell.TabBarIsVisible="True"(默认 true,调试时可临时设 false 排查)
三、让图标和文字真正居中对齐
MAUI 默认图标居左、文字左对齐,要“图标居中 + 文字居中于图标下方”,需重写
Tab的模板: 在
AppShell.xaml中为每个
<tab></tab>添加
ItemTemplate: 用
Grid布局包裹
Image和
Label,设置
HorizontalOptions="Center"和
VerticalOptions="Center"
Label加上
HorizontalTextAlignment="Center",并设
Margin="0,4,0,0"控制图文间距 避免使用
StackLayout做外层容器——它无法保证等宽分布,动态增减 Tab 时易错位
四、平台差异化微调(重点在 Windows 和 Android)
Windows 上 TabBar 是 WinUI
NavigationView模拟的,Android 则基于
BottomNavigationView,两者渲染逻辑不同: Windows:背景色支持透明度(如
#CC2c3e50),但阴影需手动加
Shadow或用
Border包裹模拟 Android:可通过自定义
TabBarHandler修改原生控件高度或禁用滑动切换动画;图标建议用
.png且尺寸为 24×24(mdpi)或 48×48(xhdpi) iOS:不支持纯色背景下的圆角裁剪,如需圆角需用
Frame包裹整个 TabBar 并设
CornerRadius所有平台都建议图标资源放在
Resources/Images下,并启用
MauiImage构建操作
基本上就这些。不需要写平台专属渲染器也能满足大多数场景,关键是把
TabBarPlacement、资源字典样式、
ItemTemplate这三层配齐,再按平台稍作验证即可稳定运行。
