目录

Adding TextInputClient.currentAutofillScope property

目录

Summary

#

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.

Context

#

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.

Description of change

#

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.

dart
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.

Migration guide

#

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

dart
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):

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

For more information, check out AutofillGroup.

Timeline

#

Landed in version: 1.18.0
In stable release: 1.20

References

#

API documentation:

Relevant issue:

Relevant PR:

除非另有说明，本文档之所提及适用于 Flutter 的最新稳定版本，本页面最后更新时间: 2024-04-04。 查看文档源码 或者 为本页面内容提出建议。