.NET MAUI 中自定义底部 TabBar 需围绕位置、背景、图标文字、居中逻辑、平台适配五点展开:一、设 Shell.TabBarPlacement="Bottom";二、用 Shell.BackgroundColor 等附加属性统一样式;三、通过 ItemTemplate 中 Grid 布局实现图标与文字居中;四、按 Windows、Android、iOS 差异微调渲染与资源;五、无需平台渲染器,配齐三层即可稳定运行。
在 .NET MAUI 中,Shell 的 TabBar 默认支持底部显示(尤其在 Android 和 Windows 上),但原生行为和样式控制需配合平台特性与 Shell 属性协同调整。自定义底部标签栏不是单纯改颜色,而是围绕位置、背景、图标文字、居中逻辑、平台适配这五个关键点展开。
基础配置必须显式设置 Shell.TabBarPlacement="Bottom",否则 Windows 和 macOS 可能默认顶部显示:
AppShell.xaml 的根 内直接设置:...
Platforms/Windows/App.xaml.cs 的 OnLaunched 中补一句强制刷新(非必需但稳妥):Microsoft.Maui.Handlers.ShellHandler.Mapper.ModifyMapping(nameof(Shell.TabBarPlacement), ...);
通过 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 中为每个 添加 ItemTemplate:Grid 布局包裹 Image 和 Label,设置 HorizontalOptions="Center" 和 VerticalOptions="Center"
Label 加上 HorizontalTextAlignment
="Center",并设 Margin="0,4,0,0" 控制图文间距StackLayout 做外层容器——它无法保证等宽分布,动态增减 Tab 时易错位Windows 上 TabBar 是 WinUI NavigationView 模拟的,Android 则基于 BottomNavigationView,两者渲染逻辑不同:
#CC2c3e50),但阴影需手动加 Shadow 或用 Border 包裹模拟TabBarHandler 修改原生控件高度或禁用滑动切换动画;图标建议用 .png 且尺寸为 24×24(mdpi)或 48×48(xhdpi)Frame 包裹整个 TabBar 并设 CornerRadius
Resources/Images 下,并启用 MauiImage 构建操作基本上就这些。不需要写平台专属渲染器也能满足大多数场景,关键是把 TabBarPlacement、资源字典样式、ItemTemplate 这三层配齐,再按平台稍作验证即可稳定运行。