MAUI Shell Flyout菜单怎么自定义 MAUI侧边栏菜单教程

来源:这里教程网 时间:2026-02-21 17:39:29 作者:

MAUI Shell 的 Flyout 菜单(侧边栏)默认简洁,但完全支持自定义——从高度、背景、图标文字,到整个内容区域都可以按需替换,不需要放弃 Shell 框架。

设置基础浮出行为和数据绑定

确保 AppShell.xaml 开头已启用 Flyout 模式,并支持绑定:

必须加
Shell.FlyoutBehavior="Flyout"
,否则菜单不响应滑动或汉堡按钮
推荐加
x:DataType="local:AppShell"
,让 XAML 编辑器识别后台代码中的属性,避免红色下划线(运行不受影响,但开发体验更好)

调整 Flyout 高度与视觉样式

Flyout 默认铺满全屏,但可通过

FlyoutHeight
控制显示区域,尤其适合避免遮挡状态栏或适配小屏:

单位是 DIP(设备无关像素),不是 px 或 % Android/Windows:从顶部开始裁剪底部;iOS:从安全区下方起算,实际可见高度可能略小 动态适配示例:在 AppShell 构造函数中调用
FlyoutHeight = (int)(DeviceDisplay.MainDisplayInfo.Height / DeviceDisplay.MainDisplayInfo.Density * 0.7);
配套样式:可用
FlyoutBackgroundColor
设纯色背景,或用
FlyoutBackgroundImage
+
FlyoutBackgroundImageAspect
加背景图

完全替换默认菜单内容

不依赖 MenuItem 自动生成,直接接管整个 Flyout 区域:

在 AppShell.xaml 中使用
<shell.flyoutcontent></shell.flyoutcontent>
标签包裹自定义布局
内部可放
Grid
ScrollView
CollectionView
,甚至带头像和用户信息的 Header 区
每个菜单项用
Button
MenuItem
(注意:后者需绑定
Command
手动导航,如
Shell.Current.GoToAsync("//home")
图标可用
FontImageSource
FileImageSource
,文字用
Label
,支持绑定 ViewModel

图标不显示?常见修复点

Android 上 FlyoutItem 图标空白、只显示文字,多数是标题栏颜色冲突导致图标透明:

在 AppShell.xaml 中给
<shell></shell>
添加:
Shell.BackgroundColor="#FFFFFF"
或明确设
Shell.TitleColor
检查图标资源是否正确部署到各平台的
Resources\appicon
Resources\raw
文件夹
若用 Font Awesome 等字体图标,确认
FontImageSource.FontFamily
在各平台已注册(如 Android 的
Fonts\fa-solid-900.ttf

基本上就这些。自定义 Flyout 不复杂但容易忽略绑定和平台差异,按需组合高度、背景、内容三块,就能做出既统一又个性的侧边栏。

相关推荐