onSubmitted property
final
Called when the user indicates that they are done editing the text in the field.
By default, onSubmitted is called after onChanged when the user has finalized editing; or, if the default behavior has been overridden, after onEditingComplete. See onEditingComplete for details.
Testing
The following is the recommended way to trigger onSubmitted in a test:
await tester.testTextInput.receiveAction(TextInputAction.done);
Sending a LogicalKeyboardKey.enter via tester.sendKeyEvent will not
trigger onSubmitted. This is because on a real device, the engine
translates the enter key to a done action, but tester.sendKeyEvent sends
the key to the framework only.
See also:
- TextInputAction.next and TextInputAction.previous, which automatically shift the focus to the next/previous focusable item when the user is done editing.
Implementation
final ValueChanged<String>? onSubmitted;