为何Xamarin.Forms中Editor的Completed事件点击即触发？

嘿，这个问题我之前帮好几个Xamarin.Forms开发者踩过坑，咱们先把根因捋清楚，再给你几个可行的解决办法：

这个异常触发主要和两个核心点有关：

• ListView的单元格复用机制：ListView默认采用RecycleElement策略复用ViewCell，当你点击Editor获取焦点时，之前被回收的单元格的Completed事件绑定可能没被正确清理，导致焦点切换时触发了旧的事件绑定，看起来像是“未按Done就触发Completed”。
• 跨平台的Editor行为差异：尤其是在iOS上，默认情况下Editor失去焦点（比如ListView滚动导致单元格移出可视区域、点击其他控件）时，系统会自动触发Completed事件，这和Android上只有按下Done/Enter才触发的逻辑不一样。

我整理了几个从临时应急到长期稳定的方案，你可以根据自己的项目情况选择：

1. 临时应急：禁用单元格复用 #

如果你的列表项不多、内存压力不大，可以先把ListView的缓存策略改成RetainElement，这样每个ViewCell都不会被复用，事件绑定就不会混乱。代码示例：

<ListView CachingStrategy="RetainElement">
    <ListView.ItemTemplate>
        <DataTemplate>
            <ViewCell>
                <Editor Focused="Editor_Focused" Completed="Editor_Completed" />
            </ViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

⚠️ 注意：这个方案不适合长列表，会显著增加内存占用。

2. 推荐方案：手动管理ViewCell的事件绑定 #

自定义ViewCell，在绑定上下文变化时，先解绑旧的Completed事件，再绑定新的，确保每个单元格的事件只关联当前的Editor。代码示例：

public class EditorViewCell : ViewCell
{
    private Editor _cellEditor;

    protected override void OnChildAdded(Element child)
    {
        base.OnChildAdded(child);
        _cellEditor = child as Editor;
    }

    protected override void OnBindingContextChanged()
    {
        base.OnBindingContextChanged();

        // 先解绑旧事件，避免复用导致的重复绑定
        if (_cellEditor != null)
        {
            _cellEditor.Completed -= OnEditorCompleted;
        }

        // 绑定新事件（只有当绑定上下文存在时）
        if (BindingContext != null && _cellEditor != null)
        {
            _cellEditor.Completed += OnEditorCompleted;
        }
    }

    private void OnEditorCompleted(object sender, EventArgs e)
    {
        // 这里写你的Completed事件逻辑
        var editor = sender as Editor;
        if (editor != null)
        {
            Console.WriteLine($"输入内容：{editor.Text}");
        }
    }
}

然后在XAML里用这个自定义ViewCell：

<ListView>
    <ListView.ItemTemplate>
        <DataTemplate>
            <local:EditorViewCell>
                <Editor />
            </local:EditorViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

3. iOS平台针对性修复 #

如果问题主要出在iOS上，我们可以自定义EditorRenderer，强制只有按下Done键才触发Completed事件，避免失去焦点误触发。代码示例（放在iOS项目里）：

[assembly: ExportRenderer(typeof(Editor), typeof(CustomEditorRenderer))]
namespace YourAppName.iOS.Renderers
{
    public class CustomEditorRenderer : EditorRenderer
    {
        protected override void OnElementChanged(ElementChangedEventArgs<Editor> e)
        {
            base.OnElementChanged(e);

            if (Control != null)
            {
                // 设置返回键为Done
                Control.ReturnKeyType = UIReturnKeyType.Done;
                
                // 拦截默认的失去焦点触发Completed行为
                Control.ShouldEndEditing = (textView) => false;
                
                // 监听Done键点击，手动触发Completed事件
                Control.ShouldReturn = (textView) =>
                {
                    textView.ResignFirstResponder();
                    Element?.SendCompleted();
                    return true;
                };
            }
        }
    }
}

4. 辅助判断：用Focus状态过滤误触发 #

在页面里维护一个焦点状态变量，在Completed事件里判断是否是真正的Done触发：

private bool _editorIsFocused;

private void Editor_Focused(object sender, FocusEventArgs e)
{
    _editorIsFocused = true;
}

private void Editor_Unfocused(object sender, FocusEventArgs e)
{
    _editorIsFocused = false;
}

private void Editor_Completed(object sender, EventArgs e)
{
    // 如果此时Editor还是聚焦状态，说明是误触发（比如ListView滚动导致的）
    if (_editorIsFocused)
    {
        return;
    }
    
    // 正常处理Completed逻辑
    var editor = sender as Editor;
    if (editor != null)
    {
        // 你的业务代码
    }
}

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