iOS平台.NET Maui切换Entry时如何保持键盘不关闭？

问题描述 #

我用.NET Maui开发iOS应用时碰到个问题：两个Entry输入框切换焦点时，键盘会先消失再重新弹出，导致界面卡顿。默认按回车键不会自动跳转到下一个输入框，我用Completed事件手动移焦点，虽然能实现跳转，但键盘闪烁的体验很差，想知道怎么让键盘保持开启状态。

原代码 #

XAML代码：

<Entry x:Name="entryOne" Completed="Entry_Completed"/>
<Entry x:Name="entryTwo" Completed="Entry_Completed"/>

后台代码：

private async void Entry_Completed(object sender, EventArgs e)
{
      //Move to next entry field
      if (sender == entryOne)
      entryTwo.Focus();
      else
      entryOne.Focus();
}

解决方案 #

方法1：iOS自定义渲染器（平台级直接解决） #

直接在iOS项目中编写自定义渲染器，拦截系统Return键的默认逻辑，阻止键盘收起。

步骤1：共享项目定义自定义Entry

public class CustomEntry : Entry
{
    // 仅作为标记，无需额外逻辑
}

步骤2：iOS项目添加渲染器

using Microsoft.Maui.Controls.Handlers.Compatibility;
using UIKit;
using YourAppNamespace; // 替换为你的共享项目命名空间

[assembly: ExportRenderer(typeof(CustomEntry), typeof(CustomEntryRenderer))]
namespace YourAppNamespace.iOS.Renderers
{
    public class CustomEntryRenderer : EntryRenderer
    {
        protected override void OnElementChanged(ElementChangedEventArgs<Entry> e)
        {
            base.OnElementChanged(e);

            if (Control != null)
            {
                // 接管Return键处理逻辑
                Control.ShouldReturn = textField =>
                {
                    var nextEntry = GetNextEntry();
                    if (nextEntry != null)
                    {
                        nextEntry.Focus();
                        return false; // 返回false，阻止系统收起键盘
                    }
                    return true; // 无后续输入框时允许收起键盘
                };
            }
        }

        private Entry GetNextEntry()
        {
            // 假设Entry在同一Layout容器中，按顺序切换焦点
            var parentLayout = Element.Parent as Layout;
            if (parentLayout == null) return null;

            var currentIndex = parentLayout.Children.IndexOf(Element);
            var nextIndex = currentIndex == parentLayout.Children.Count - 1 ? 0 : currentIndex + 1;
            return parentLayout.Children[nextIndex] as Entry;
        }
    }
}

步骤3：XAML替换Entry为CustomEntry

<local:CustomEntry x:Name="entryOne" />
<local:CustomEntry x:Name="entryTwo" />
<!-- 需在XAML顶部添加命名空间：xmlns:local="clr-namespace:YourAppNamespace" -->

方法2：使用Maui行为（跨平台友好） #

编写可复用的Behavior，绑定到Entry的ReturnCommand上，直接切换焦点，绕开Completed事件的默认键盘收起逻辑。

步骤1：创建NextEntryBehavior

public class NextEntryBehavior : Behavior<Entry>
{
    // 绑定目标Entry的属性
    public static readonly BindableProperty NextEntryProperty =
        BindableProperty.Create(nameof(NextEntry), typeof(Entry), typeof(NextEntryBehavior));

    public Entry NextEntry
    {
        get => (Entry)GetValue(NextEntryProperty);
        set => SetValue(NextEntryProperty, value);
    }

    protected override void OnAttachedTo(Entry bindable)
    {
        base.OnAttachedTo(bindable);
        // 给Return键绑定自定义命令
        bindable.ReturnCommand = new Command(() =>
        {
            NextEntry?.Focus();
        });
    }

    protected override void OnDetachingFrom(Entry bindable)
    {
        base.OnDetachingFrom(bindable);
        bindable.ReturnCommand = null;
    }
}

步骤2：XAML中使用Behavior

<Entry x:Name="entryOne">
    <Entry.Behaviors>
        <local:NextEntryBehavior NextEntry="{x:Reference entryTwo}" />
    </Entry.Behaviors>
</Entry>
<Entry x:Name="entryTwo">
    <Entry.Behaviors>
        <local:NextEntryBehavior NextEntry="{x:Reference entryOne}" />
    </Entry.Behaviors>
</Entry>
<!-- 需添加local命名空间引用 -->

问题根源 #

原来的Completed事件触发时，iOS系统会先执行默认逻辑——收起当前键盘，再执行我们写的Focus()方法，这就导致了键盘先消失再弹出的闪烁。上面两种方法都是直接接管了Return键的处理，不让系统触发键盘收起逻辑，直接切换焦点，从而保持键盘持续显示。

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