.NET MAUI安卓端WebView软键盘遮挡输入框，Chrome正常

全局设置android:Application.WindowSoftInputModeAdjust="Pan"对WebView不生效，是因为Android平台的WebView有独立的滚动处理逻辑，会覆盖全局软键盘模式设置。可以通过以下几种方式解决：

1. 针对WebView所在页面单独设置软键盘模式 #

在包含WebView的ContentPage代码后台（如MainPage.xaml.cs）中，添加Android平台专属设置：

using Microsoft.Maui.Controls.PlatformConfiguration;
using Microsoft.Maui.Controls.PlatformConfiguration.AndroidSpecific;

protected override void OnAppearing()
{
    base.OnAppearing();
    // 为当前页面设置Pan模式
    this.On<Android>().SetWindowSoftInputModeAdjust(WindowSoftInputModeAdjust.Pan);
}

2. 自定义WebViewHandler强制设置原生行为 #

通过自定义Handler直接修改Android原生WebView的关联配置：

步骤1：创建自定义Handler（Platforms/Android目录下） #

using Android.Webkit;
using Microsoft.Maui.Handlers;

namespace YourAppNamespace.Platforms.Android;

public class CustomWebViewHandler : WebViewHandler
{
    protected override void ConnectHandler(Android.Webkit.WebView platformView)
    {
        base.ConnectHandler(platformView);
        
        // 配置WebView滚动样式，确保支持窗口平移
        platformView.ScrollBarStyle = Android.Views.ScrollbarStyles.InsideOverlay;
        
        // 获取当前Activity，强制设置软键盘Pan模式
        var currentActivity = Platform.CurrentActivity;
        if (currentActivity != null)
        {
            currentActivity.Window.SetSoftInputMode(Android.Views.SoftInput.AdjustPan);
        }
    }
}

步骤2：注册自定义Handler（MauiProgram.cs） #

builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    handlers.AddHandler<WebView, YourAppNamespace.Platforms.Android.CustomWebViewHandler>();
#endif
});

3. 调整WebView布局避免冲突 #

• 不要将WebView嵌套在ScrollView中，否则会导致滚动逻辑冲突，软键盘Pan行为失效。
• 确保WebView占据页面可用空间，示例布局：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="YourAppNamespace.MainPage">
    <Grid>
        <WebView Source="https://your-web-app-url.com" />
    </Grid>
</ContentPage>

关键注意事项 #

• AdjustPan模式依赖窗口整体平移，因此WebView所在布局不能是固定高度或固定定位的元素。
• 页面级别的软键盘设置优先级高于全局设置，确保没有其他代码覆盖了Pan模式。

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