iOS 18 iPad端MAUI应用TabBar移至顶部，如何恢复底部显示？

方法：通过平台特定代码强制TabBar位于底部 #

苹果在iOS 18中针对iPad调整了TabBar的默认行为，将其移至屏幕顶部。要在MAUI中恢复传统的底部显示，需通过iOS原生API修改TabBar的位置设置，以下是两种可行方案：

方案1：使用兼容性自定义渲染器 #

在项目的Platforms/iOS目录下创建自定义渲染器类：

using Microsoft.Maui.Controls.Handlers.Compatibility;
using UIKit;

namespace YourAppNamespace.Platforms.iOS;

public class CustomTabBarRenderer : TabbedRenderer
{
    protected override void OnElementChanged(VisualElementChangedEventArgs e)
    {
        base.OnElementChanged(e);

        if (TabBar != null)
        {
            // 禁用iOS 18的顶部TabBar特性
            TabBar.SetValue(UITabBar.PrefersTopAttachedProperty, false);
        }
    }
}

接着在Platforms/iOS/Program.cs中注册该渲染器：

using YourAppNamespace.Platforms.iOS;

namespace YourAppNamespace;

public class Program
{
    static void Main(string[] args)
    {
        Microsoft.Maui.Controls.Compatibility.Renderers.RendererFactory.RegisterRenderer(typeof(Microsoft.Maui.Controls.TabbedPage), typeof(CustomTabBarRenderer));
        
        var mauiApp = MauiProgram.CreateMauiApp().Build();
        mauiApp.Run();
    }
}

方案2：使用MAUI现代Handler自定义（推荐） #

在Platforms/iOS/Program.cs的CreateMauiApp方法中配置Handler：

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AppendHandler<Microsoft.Maui.Controls.TabbedPage, CustomTabbedPageHandler>();
#endif
});

然后在Platforms/iOS目录下创建自定义Handler类：

using Microsoft.Maui.Controls.Handlers;
using UIKit;

namespace YourAppNamespace.Platforms.iOS;

public class CustomTabbedPageHandler : TabbedPageHandler
{
    protected override void ConnectHandler(UITabBarController platformView)
    {
        base.ConnectHandler(platformView);
        
        if (platformView.TabBar != null)
        {
            // 强制TabBar保持在底部
            platformView.TabBar.PrefersTopAttached = false;
        }
    }
}

原理说明 #

iOS 18为iPad的UITabBar新增了PrefersTopAttached属性，默认值为true，会触发顶部布局逻辑。将该属性设置为false即可恢复传统的底部TabBar显示。

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