Flutter TextField组件中onSubmitted和onEditingComplete的区别是什么？

核心差异 #

• onSubmitted：携带当前输入框的文本值作为入参触发回调，触发时机为用户点击键盘上的提交类按钮（具体按钮文案由textInputAction属性决定，常见的有完成、搜索、发送、下一步等）。该回调没有默认附带行为，通常用于直接获取用户输入内容执行提交、搜索等业务逻辑。
• onEditingComplete：无入参的回调，触发时机早于onSubmitted，默认附带自动收起键盘的行为。如果开发者重写了该回调，默认的收起键盘行为会失效，需要手动调用FocusScope.of(context).unfocus()才能收起键盘。

如果同时配置了两个回调，触发顺序为：先执行onEditingComplete的逻辑，再执行onSubmitted的逻辑。

为什么用回调而非hideKeyboardAfterEditing布尔属性 #

onEditingComplete的核心作用不是仅控制是否收起键盘，而是给开发者提供输入完成后的全流程控制权，布尔属性覆盖不了复杂的业务场景，常见的自定义场景包括：

• 多输入框表单的焦点跳转：比如注册页依次有手机号、验证码、密码输入框，用户填完手机号点击键盘的「下一步」按钮时，不需要收起键盘，直接在onEditingComplete中调用FocusScope.of(context).nextFocus()就能把焦点切到下一个输入框，提升输入效率。
• 前置校验拦截：用户点击提交按钮后，先在onEditingComplete中校验输入格式是否合法，如果不合法直接弹出提示，不收起键盘、保留当前输入框焦点，方便用户直接修改内容，不需要用户重新点击输入框唤起键盘。
• 自定义交互逻辑联动：比如连续输入的场景，输入完成后不需要收起键盘，直接清空当前输入框等待用户下一次输入，这类逻辑都可以在onEditingComplete中实现。

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