.NET Maui iOS端TabbedPage首次点击标签时Border弹出问题

问题复现场景 #

用C#动态生成包含4个ContentPage的TabbedPage，页面加载时通过代码连续切换CurrentPage：

TabbedPage.CurrentPage = TabbedPage.Children[1];
TabbedPage.CurrentPage = TabbedPage.Children[2];
TabbedPage.CurrentPage = TabbedPage.Children[3];

此时iOS端会出现以下问题：

• 点击除最终停留的索引3页面外的其他标签（比如索引0），页面内的Border控件会从左上角以小尺寸展开至完整大小，伴随轻微动画
• Border内部的文本无异常，首次点击后该现象不再出现
• Android端无此问题

原因分析 #

iOS端的视图生命周期机制与Android不同，连续快速切换CurrentPage时，未最终停留的页面的视图未完成完整的布局初始化。首次激活这些页面时，Border控件的布局系统会触发默认的布局动画，表现为展开效果。

解决方案 #

1. 移除多余的CurrentPage切换操作

直接设置最终需要停留的页面，避免中间不必要的切换，从根源上避免视图布局异常：

// 仅保留最终目标页面的赋值
TabbedPage.CurrentPage = TabbedPage.Children[3];

2. 预初始化页面布局（若需保留中间切换逻辑）

如果业务上必须经过中间页面切换，可提前触发未显示页面的布局初始化：
在TabbedPage的构造函数或Loaded事件中，遍历所有子页面并触发布局：

foreach (var page in Children)
{
    // 触发页面布局加载
    page.ForceLayout();
    // 若Border在页面的ContentView内，可进一步触发ContentView的布局
    if (page.Content is ContentView contentView)
    {
        contentView.ForceLayout();
    }
}

3. 禁用iOS端Border的布局动画

针对iOS平台，自定义Border的Handler来关闭默认布局动画：
在项目的Platforms/iOS目录下创建或修改自定义Handler：

using Microsoft.Maui.Handlers;
using UIKit;

namespace YourAppName.Platforms.iOS;

public class CustomBorderHandler : BorderHandler
{
    protected override void ConnectHandler(UIKit.UIView platformView)
    {
        base.ConnectHandler(platformView);
        // 禁用布局动画
        platformView.LayoutIfNeeded();
        UIView.PerformWithoutAnimation(() =>
        {
            platformView.SetNeedsLayout();
            platformView.LayoutIfNeeded();
        });
    }
}

然后在MauiProgram.cs中注册该Handler：

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler<Border, Platforms.iOS.CustomBorderHandler>();
#endif
});

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