Adding TextInputClient.currentAutofillScope property

A new getter, TextInputClient.currentAutofillScope, was added to the TextInputClient interface; all TextInputClient subclasses must provide a concrete implementation of currentAutofillScope.

This getter allows the TextInputClient to trigger an autofill that involves multiple logically connected input fields. For example, a "username" field can trigger an autofill that fills both itself and the "password" field associated with it.

On many platforms, autofill services are capable of autofilling multiple input fields in a single autofill attempt. For example, username fields and password fields can usually be autofilled in one go. For this reason, a Flutter input field that is about to trigger autofill should also provide the platform with information about other autofillable input fields logically connected to it. TextInputClient.currentAutofillScope defines the group of input fields that are logically connected to this TextInputClient, and can be autofilled together.

TextInputClient now has an additional getter that returns the AutofillScope that this client belongs to. This getter is used by the input client to collect autofill related information from other autofillable input fields within the same scope.

abstract class TextInputClient {
  AutofillScope get currentAutofillScope;
}

If you see the error message "missing concrete implementation of 'getter TextInputClient.currentAutofillScope'" while compiling a Flutter app, follow the migration steps listed below.

If you're not planning to add multifield autofill support to your TextInputClient subclass, simply return null in the getter:

class CustomTextField implements TextInputClient {
  // Not having an AutofillScope does not prevent the input field
  // from being autofilled. However, only this input field is
  // autofilled when autofill is triggered on it.
  AutofillScope get currentAutofillScope => null;
}

If multifield autofill support is desirable, a common AutofillScope to use is the AutofillGroup widget. To get the closest AutofillGroup widget to the text input, use AutofillGroup.of(context):

class CustomTextFieldState extends State<CustomTextField> implements TextInputClient {
  AutofillScope get currentAutofillScope => AutofillGroup.of(context);
}

For more information, check out AutofillGroup.

Landed in version: 1.18.0
In stable release: 1.20

API documentation:

• AutofillGroup
• TextInputClient.currentAutofillScope

Relevant issue:

• Issue 13015: Autofill support

Relevant PR:

• Framework PR that added autofill support

Unless stated otherwise, the documentation on this site reflects the latest stable version of Flutter. Page last updated on 2024-04-04. View source or report an issue.