[ndonkoHenri]

Fixes #6962.

On a phone, a single-line TextField always shows Done on the keyboard, and pressing it closes the keyboard. Moving to the next field from on_submit with focus() can't avoid that: by the time the call comes back from Python, Flutter has already dropped focus and is hiding the keyboard, so it closes and reopens on every field.

This adds text_input_action to TextField and CupertinoTextField, with a TextInputAction enum that mirrors Flutter's. With NEXT, Flutter moves focus to the next field in the same frame, so the keyboard stays open, and on_submit still fires:

ft.TextField(label="Name", text_input_action=ft.TextInputAction.NEXT)
ft.TextField(label="Email", text_input_action=ft.TextInputAction.NEXT)
ft.TextField(label="Message", text_input_action=ft.TextInputAction.SEND, on_submit=send)

When it isn't set, fields behave as before: Done on single-line fields, a new line on multiline ones.

Changes

• Python: TextInputAction enum and TextField.text_input_action. The field is keyword-only, so the positional arguments of TextField and its subclass CupertinoTextField don't shift.
• Dart: parseTextInputAction() / Control.getTextInputAction(), passed to TextFormField and CupertinoTextField.
• Docs: the enum docs say what each action does with focus and which platforms support it, and a new keyboard_actions example is shown on the TextField and TextInputAction pages.

Testing

Tested with a probe app on the iOS Simulator (iOS 26.5, debug build) and an Android 16 emulator (release APK):

• NEXT moves focus with the keyboard open the whole time (checked on every frame of a screen recording on iOS, and by polling the IME state on Android), and on_submit fires.
• DONE, GO, SEARCH and SEND close the keyboard after on_submit, and each shows its own key.
• PREVIOUS (Android), CupertinoTextField, multiline fields (no new line and no on_submit with DONE/NEXT), and changing the action at runtime (applies on the next focus) all behave as documented.
• Fields without the property are unchanged.

Web was tested earlier in headless Chromium: the browser gets the matching enterkeyhint, and Enter performs the action.

Things worth knowing

• In a debug build, an action the platform doesn't support (such as PREVIOUS on iOS) leaves the field focused with no keyboard and no error. Android release builds fall back to the default key. This is documented on the enum.
• NEXT follows reading order, so a focusable suffix button gets focus before the next field. Flet has no way to take a button out of focus traversal, so that would be a separate feature.
• On multiline fields the action key never calls on_submit, because Flet only wires it for single-line fields. That predates this change.

Summary by Sourcery

Enable configurable onscreen keyboard actions for text fields, including seamless focus chaining between form fields.

New Features:

• Add a TextInputAction enum and text_input_action property to TextField and CupertinoTextField for selecting mobile keyboard actions and controlling focus behavior.

Enhancements:

• Support parsing the configured text input action across native text field controls while preserving existing defaults when unset.

Documentation:

• Document TextInputAction behavior, platform support, and keyboard-action form usage with a new example and reference page.

[sourcery-ai]

Hey - I've reviewed your changes and they look great!

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

[cloudflare-workers-and-pages]

Deploying flet-website-v2 with    Cloudflare Pages

Latest commit:	4190d4e
Status:	✅  Deploy successful!
Preview URL:	https://bec3846a.flet-website-v2.pages.dev
Branch Preview URL:	https://feat-textfield-text-input-ac.flet-website-v2.pages.dev

View logs