firka/flutter
firka/flutter
5
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarify that inputFormatters don't run on programmatical changes (#106904)

Browse Source
This commit is contained in:
LongCatIsLooong 2022-07-06 16:19:09 -07:00 committed by GitHub
parent 78b38b77b9
commit 0a06644c38
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 13 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
packages/flutter/lib/src/painting/text_style.dart
View File

@ -504,7 +504,7 @@ class TextStyle with Diagnosticable {
/// style (e.g., in a [TextSpan] tree). /// style (e.g., in a [TextSpan] tree).
/// ///
/// If this is false, properties that don't have explicit values will revert /// 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. /// font face.
final bool inherit; final bool inherit;

15
packages/flutter/lib/src/widgets/editable_text.dart
View File

@ -1070,6 +1070,8 @@ class EditableText extends StatefulWidget {
/// runs and can validate and change ("format") the input value. /// runs and can validate and change ("format") the input value.
/// * [onEditingComplete], [onSubmitted], [onSelectionChanged]: /// * [onEditingComplete], [onSubmitted], [onSelectionChanged]:
/// which are more specialized input change notifications. /// which are more specialized input change notifications.
/// * [TextEditingController], which implements the [Listenable] interface
/// and notifies its listeners on [TextEditingValue] changes.
final ValueChanged<String>? onChanged; final ValueChanged<String>? onChanged;
/// {@template flutter.widgets.editableText.onEditingComplete} /// {@template flutter.widgets.editableText.onEditingComplete}
@ -1133,9 +1135,16 @@ class EditableText extends StatefulWidget {
/// {@template flutter.widgets.editableText.inputFormatters} /// {@template flutter.widgets.editableText.inputFormatters}
/// Optional input validation and formatting overrides. /// Optional input validation and formatting overrides.
/// ///
/// Formatters are run in the provided order when the text input changes. When /// Formatters are run in the provided order when the user changes the text
/// this parameter changes, the new formatters will not be applied until the /// this widget contains. When this parameter changes, the new formatters will
/// next time the user inserts or deletes text. /// 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} /// {@endtemplate}
final List<TextInputFormatter>? inputFormatters; final List<TextInputFormatter>? inputFormatters;