onSubmitted property
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;