Clarify that inputFormatters don't run on programmatical changes (#106904)
This commit is contained in:
parent
78b38b77b9
commit
0a06644c38
@ -504,7 +504,7 @@ class TextStyle with Diagnosticable {
|
||||
/// style (e.g., in a [TextSpan] tree).
|
||||
///
|
||||
/// If this is false, properties that don't have explicit values will revert
|
||||
/// to the defaults: white in color, a font size of 10 pixels, in a sans-serif
|
||||
/// to the defaults: white in color, a font size of 14 pixels, in a sans-serif
|
||||
/// font face.
|
||||
final bool inherit;
|
||||
|
||||
|
@ -1070,6 +1070,8 @@ class EditableText extends StatefulWidget {
|
||||
/// runs and can validate and change ("format") the input value.
|
||||
/// * [onEditingComplete], [onSubmitted], [onSelectionChanged]:
|
||||
/// which are more specialized input change notifications.
|
||||
/// * [TextEditingController], which implements the [Listenable] interface
|
||||
/// and notifies its listeners on [TextEditingValue] changes.
|
||||
final ValueChanged<String>? onChanged;
|
||||
|
||||
/// {@template flutter.widgets.editableText.onEditingComplete}
|
||||
@ -1133,9 +1135,16 @@ class EditableText extends StatefulWidget {
|
||||
/// {@template flutter.widgets.editableText.inputFormatters}
|
||||
/// Optional input validation and formatting overrides.
|
||||
///
|
||||
/// Formatters are run in the provided order when the text input changes. When
|
||||
/// this parameter changes, the new formatters will not be applied until the
|
||||
/// next time the user inserts or deletes text.
|
||||
/// Formatters are run in the provided order when the user changes the text
|
||||
/// this widget contains. When this parameter changes, the new formatters will
|
||||
/// not be applied until the next time the user inserts or deletes text.
|
||||
/// Similar to the [onChanged] callback, formatters don't run when the text is
|
||||
/// changed programmatically via [controller].
|
||||
///
|
||||
/// See also:
|
||||
///
|
||||
/// * [TextEditingController], which implements the [Listenable] interface
|
||||
/// and notifies its listeners on [TextEditingValue] changes.
|
||||
/// {@endtemplate}
|
||||
final List<TextInputFormatter>? inputFormatters;
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user