.NET MAUI iOS应用中如何禁用WebView的多标签功能？

在iOS端，我们需要通过自定义WebViewHandler并拦截WKWebView的新窗口请求来实现禁用多标签/多窗口功能，具体实现如下：

1. 自定义iOS WebView Handler #

创建继承自WebViewHandler的自定义处理器，同时实现自定义的WKUIDelegate来拦截新窗口创建请求：

using Microsoft.Maui.Handlers;
using WebKit;
using UIKit;

namespace YourAppNamespace;

public class iOSWebViewHandler : WebViewHandler
{
    protected override WKWebView CreatePlatformView()
    {
        var config = new WKWebViewConfiguration();
        var webView = new WKWebView(CGRect.Empty, config);
        // 绑定自定义UIDelegate以拦截新窗口请求
        webView.UIDelegate = new CustomWKUIDelegate();
        return webView;
    }
}

public class CustomWKUIDelegate : WKUIDelegate
{
    // 拦截JavaScript或target="_blank"触发的新窗口请求
    public override WKWebView? CreateWebView(WKWebView webView, WKWebViewConfiguration configuration, WKNavigationAction navigationAction, WKWindowFeatures windowFeatures)
    {
        // 将请求转到当前WebView加载，而非打开新窗口
        if (navigationAction.Request.Url != null)
        {
            webView.LoadRequest(navigationAction.Request);
        }
        // 返回null表示不创建新窗口
        return null;
    }

    // 可选：实现必要的弹窗处理方法（避免JS弹窗报错）
    public override void RunJavaScriptAlertPanel(WKWebView webView, string message, WKFrameInfo frameInfo, Action completionHandler)
    {
        completionHandler();
    }
}

2. 注册自定义Handler #

在MauiProgram.cs中注册iOS平台的自定义WebView处理器：

var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler<IWebView, iOSWebViewHandler>();
#endif
});

return builder.Build();

实现原理 #

iOS的WKWebView默认允许通过JavaScript或target="_blank"的链接打开新窗口。通过自定义WKUIDelegate的CreateWebView方法，我们可以拦截所有新窗口创建请求，将请求重定向到当前WebView加载，同时返回null来阻止系统创建新的WebView窗口，从而达到禁用多标签/多窗口的效果。

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