.NET MAUI无需NoLayoutLimits实现透明状态栏且避免键盘遮挡输入框

问题描述 #

我在.NET MAUI开发中需要将状态栏设置为透明，尝试使用LayoutHasNoLimits以及CommunityToolkit.Maui包的StatusBarBehavior实现后，发现状态栏透明时键盘会遮挡Entry输入框，无法自动上推控件；同时也试过StackOverflow上的相关解决方案，但问题仍存在。现寻求既能保持状态栏透明，又能让键盘正常上推Entry的解决办法。

用到的XAML代码 #

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:tool="clr-namespace:CommunityToolkit.Maui.Behaviors;assembly=CommunityToolkit.Maui"
             x:Class="StatusbarTry.MainPage">
    <ContentPage.Behaviors>
        <tool:StatusBarBehavior StatusBarColor="Transparent"/>
    </ContentPage.Behaviors>
    <ScrollView>
        <Grid RowDefinitions="7*,2*">
            <Entry x:Name="entry" WidthRequest="200" HeightRequest="40" VerticalOptions="End"/>
        </Grid>
    </ScrollView>
</ContentPage>

问题截图 #

• 无键盘时的主页面：
  

• 弹出键盘时的主页面：
  

解决办法 #

方案1：调整安全区域与页面布局 #

状态栏透明后，MAUI可能无法正确识别安全区域导致布局计算错误，可通过以下方式修正：

1. 在XAML中给ContentPage启用安全区域，并为ScrollView绑定平台专属的内边距，确保内容布局逻辑正确：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:tool="clr-namespace:CommunityToolkit.Maui.Behaviors;assembly=CommunityToolkit.Maui"
             x:Class="StatusbarTry.MainPage"
             UseSafeArea="True">
    <ContentPage.Behaviors>
        <tool:StatusBarBehavior StatusBarColor="Transparent"/>
    </ContentPage.Behaviors>
    <!-- 根据平台设置安全区域内边距，避免状态栏遮挡内容 -->
    <ScrollView Padding="{OnPlatform Android='0,0,0,0', iOS='0,{x:Static SafeAreaInsets.Top},0,0'}">
        <Grid RowDefinitions="7*,2*">
            <Entry x:Name="entry" WidthRequest="200" HeightRequest="40" VerticalOptions="End"/>
        </Grid>
    </ScrollView>
</ContentPage>

2. 针对Android，可在后台代码补充窗口配置，确保状态栏透明后布局逻辑正常：

public MainPage()
{
    InitializeComponent();
#if ANDROID
    Microsoft.Maui.Handlers.WindowHandler.Mapper.AppendToMapping(nameof(IWindow), (handler, view) =>
    {
        var window = handler.PlatformView;
        window.SetDecorFitsSystemWindows(false);
        var insetsController = WindowInsetsControllerCompat.GetInsetsController(window, window.DecorView);
        insetsController?.SystemBarsBehavior = WindowInsetsControllerCompat.BehaviorShowTransientBarsBySwipe;
    });
#endif
}

方案2：配置Android软输入模式 #

修改Android项目的AndroidManifest.xml，设置窗口软输入模式为adjustResize，让系统自动调整窗口大小适配键盘：

<activity android:name=".MainActivity"
          android:windowSoftInputMode="adjustResize">
</activity>

该配置配合ScrollView可实现键盘弹出时自动上推内容。

方案3：自定义键盘监听行为（Android专属） #

如果上述方案无效，可通过自定义行为监听键盘高度变化，动态调整ScrollView的底部内边距：

1. 创建自定义Behavior类：

using Microsoft.Maui.Controls;
using Android.Views;
using Android.Content;
using Android.OS;

namespace StatusbarTry.Behaviors;

public class KeyboardAdjustBehavior : Behavior<ScrollView>
{
    private ScrollView _scrollView;
    private ViewTreeObserver.IOnGlobalLayoutListener _layoutListener;

    protected override void OnAttachedTo(ScrollView bindable)
    {
        base.OnAttachedTo(bindable);
        _scrollView = bindable;
#if ANDROID
        var activity = Platform.CurrentActivity;
        var rootView = activity.Window.DecorView.RootView;
        _layoutListener = new GlobalLayoutListener(this, rootView, activity);
        rootView.ViewTreeObserver.AddOnGlobalLayoutListener(_layoutListener);
#endif
    }

    protected override void OnDetachingFrom(ScrollView bindable)
    {
        base.OnDetachingFrom(bindable);
#if ANDROID
        var activity = Platform.CurrentActivity;
        var rootView = activity.Window.DecorView.RootView;
        rootView.ViewTreeObserver.RemoveOnGlobalLayoutListener(_layoutListener);
#endif
        _scrollView = null;
    }

    private class GlobalLayoutListener : Java.Lang.Object, ViewTreeObserver.IOnGlobalLayoutListener
    {
        private readonly KeyboardAdjustBehavior _behavior;
        private readonly View _rootView;
        private readonly Activity _activity;
        private int _originalHeight;

        public GlobalLayoutListener(KeyboardAdjustBehavior behavior, View rootView, Activity activity)
        {
            _behavior = behavior;
            _rootView = rootView;
            _activity = activity;
            _originalHeight = rootView.Height;
        }

        public void OnGlobalLayout()
        {
            var r = new Rect();
            _rootView.GetWindowVisibleDisplayFrame(r);
            var heightDiff = _originalHeight - (r.Bottom - r.Top);
            // 判定键盘是否弹出（高度差超过屏幕15%）
            if (heightDiff > _originalHeight * 0.15)
            {
                _behavior._scrollView.Padding = new Thickness(0, 0, 0, heightDiff);
            }
            else
            {
                _behavior._scrollView.Padding = new Thickness(0);
            }
        }
    }
}

2. 在XAML中引用该行为：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:tool="clr-namespace:CommunityToolkit.Maui.Behaviors;assembly=CommunityToolkit.Maui"
             xmlns:local="clr-namespace:StatusbarTry.Behaviors"
             x:Class="StatusbarTry.MainPage">
    <ContentPage.Behaviors>
        <tool:StatusBarBehavior StatusBarColor="Transparent"/>
    </ContentPage.Behaviors>
    <ScrollView>
        <ScrollView.Behaviors>
            <local:KeyboardAdjustBehavior/>
        </ScrollView.Behaviors>
        <Grid RowDefinitions="7*,2*">
            <Entry x:Name="entry" WidthRequest="200" HeightRequest="40" VerticalOptions="End"/>
        </Grid>
    </ScrollView>
</ContentPage>

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