junny_forme 4.3.1+1

junny_forme: ^4.3.1+1 copied to clipboard

1. improve validation behavior

1. improve validation performance

1. update Flutter to 3.7 and sdk to 2.17
2. name of FormeField is nullable now
3. remove registable from FormeField
4. FormeFieldInitialed rename to FormeFieldInitialized

1. hashValues replace with Object.hash
2. and maybeField method on FormeState

1. update Object? to dynamic

1. remove unnecessary imports

1. export FormeDecoratorState

1. remove SchedulerBinding runtime warnings

1. bug fix:onStatusChanged not triggered when focus changed

1. support specify FocusNode on FormeField

1. allow subclass extends FormeFieldStatus & FormeFieldChangedStatus

1. add FormeFieldValidationFilter on FormeField , used to determine whether perform validation or not

1. remove FormeController and FormeFieldController , use FormeState and FormeFieldState instead
2. remove onValueChanged,onFocusChanged... from FormeField , use onStatusChanged instead
3. add FormeFieldStatusListener widget to listen status change
4. add FormeFieldsValidationListener widget to listen multi fields validation change
5. add FormeIsValueChangedListener widget to listen form value change
6. add FormeValidationListener widget to listen form validation change
7. add FormeValueListener widget to listen form value change
8. remove onValidationChanged from Forme
9. remove beforeInitiaion and afterInitiaion , use initStatus instead
10. add onInitialed on Forme
11. add FormeVisitor and FormeFieldVisitor, used to listen fields registered|unregistered|status changed

1. FormeField's runtimeType will return FormeFieldType , if FormeField has same original runtimeType and different name , they will be recognised as different field

1. add markNeedsRebuild method on FormeFieldController
2. add onReadonlyChanged onEnableChanged on FormeFieldState

1. if value changed in didUpdateWidget , ValueListenable will be notified when frame completed

1. add FormeAsyncOperationHelper to simplify async operation

BREAKING CHANGES:

1. moved material widgets & cupertino widgets to a single package

1. FormeCupertinoTextField&FormeTextField add updateValueWhenComposing

1. FormeDropdownButton add beforeValueChanged , used to check whether value can be changed or not

1. FormeFieldController add type and isNullable getter

1. FormeDateTimeField add timePickerBuilder , alwaysUse24HourFormat will not work if timePickerBuilder is not null

1. FormeDropdownButton update

1. support maxLength & counter on FormeInputDecoratorBuilder

1. bug fix

1. FormeController.fieldListenable will triggered after frame completed
2. FormeController add fieldsListenable , used to listen every field
3. Forme add onFieldsChanged
4. bug fix: when Forme's autovalidateMode is always , reset form will validate twice
5. Forme onValidationChanged renamed to onFieldValidationChanged
6. Forme add onValidationChanged, used to listen FormeValidation changed

1. bug fix

1. support enabled on FormeField

if field is disabled:

1. field will lose focus and can not be focused , but you still can get focusNode from `FormeFieldController` and set `canRequestFocus` to true and require focus
2. field's validators are ignored (manually validation will  be also ignored)
3. field is readOnly
4. value will be ignored when get form data
5. value can still be changed via `FormeFieldController`
6. validation state will always be `FormeValidationState.unnecessary`
7. when get validation from `FormeController` , this field will be ignored

2. asyncValidator add a isValid function param ,API BREAK
3. remove comparator from FormeField , you can override FormeFieldState's compareValue method do the same
4. update dialog style of FormeCupertinoDateTimeField and FormeCupertinoTimerField

1. support FormeCheckboxTile
2. support FormeSwitchTile

1. first argument of FormeInputDecoratorBuilder's emptyChecker has been replaced by T

1. move to FormeAutocomplete & FormeAsyncAutocomplete to forme_fields package
2. FormeInputDecoratorBuilder's wrapper and emptyChecker add FormFieldController<T> as second argument , this will break your codes

1. replace EdgeInsets with EdgeInsetsGeometry in some files
2. bug fix: if value in FormeNumerTextField bigger than max ,backspace will not work

1. bug fix

1. FormeAsyncAutocomplete can override default suffixIcon

1. support set FocusNode in FormeFieldState
2. support FormeAutocomplete
3. FormeCheckbox is bool? now
4. support FormeAsyncAutocomplete

1. fix FormeValidation can not be found

1. remove hasValidator
2. onErrorChanged renamed to onValidationChanged
3. FormeValidateError renamed to FormeValidation
4. FormeValidateState renamed to FormeValidationState and add new state unnecessary and waiting

1. support hasValidator on FormeFieldController
2. support errorListenable on FormeController
3. add FormeValidateErrorBuilder widget
4. use FormeField.of get FormeFieldController and it is nullable
5. use Forme.of get FormeController and it is nullable

Forme3 is not an upgrade but a simple version of Forme2

differences:

1. Forme3 removed model which used to provide render data in Forme2 and moved model properties into field's constructor
2. Forme3 removed listener from field's constructor and moved listener properties into field's constructor
3. Forme3 removed CommonField and renamed ValueField to FormeField
4. Forme3 has big api breaks
5. Forme3 is based on flutter 2.5

1. BaseValueField support quietlyValidate
2. FormeController add fieldListenable method , used to listen field's initial and dispose

1. FormeController's validate method support clearError and validateByOrder params. if clearError is true , field error will be cleared before validate. if validateByOrder is true , will only validate one field at a time , and break validation chain if any field validate not passed or failed

1. add autovalidateByOrder on Forme ,support validate form fields by order , and stop validate further if validate failed
2. add a nullable attribute order on BaseValueField
3. Future<Map<FormeValueFieldController, String>> validate({bool quietly = false}) changed to Future<FormeValidateSnapshot> validate({bool quietly = false, Set<String> names = const {}})
4. Future<String?>? validate({bool quietly = false}) changed to Future<FormeFieldValidateSnapshot<T>> validate({bool quietly = false})
5. add isValueChanged method on FormeController , used to check whether form data changed after initialed

1. remove onValueChanged,onValidationChanged,onFocusChanged,onInitialed,validator,autovalidateMode on Field , they are moved to FormeFieldListener , validator is renamed to onValidate
2. support onAsyncValidate and asyncValidatorDebounce on FormeValueFieldListener to support async validate
3. remove fieldListenable from FormeFieldController
4. remove lazyFieldListenable from FormeKey
5. ValueField is not a FormField any more
6. you can create a nonnull or nullable ValueField by ValueField's generic type , eg:ValueField<String> is nonnull , but ValueField<String?> is nullable
7. remove clearValue from FormeValueFieldController
8. support 'autovalidateMode' on Forme

1. remove buildTextSpan from FormeTextFieldController , it cannot be compiled success before flutter 2.2.2

1. bug fix: can't get current field error in onValueChanged
2. FormeSingleSwitch & FormeListTile always use material switch
3. FormeValidates add range and equals vaidator

1. remove Cupertino fields ,they will be moved to another package
2. FormeSlider and FormeRangeSlider will perform validate in onChangeEnd ,not in onChange
3. FormeTextField's controller can be cast to FormeTextController, set TextEditingValue and Selection is easily via this controller
4. FormeValueFieldController support nextFocus , used to focus next focusable widget
5. remove beforeUpdateModel from AbstractFieldState , you can do some logic in afterUpdateModel
6. AbstractFieldState's didUpdateWidget will call afterUpdateModel by default
7. bug fix

1. bug fix: timer in FormeRawAutocomplete will be cancelled in dispose !

1. add modelListenable on FormeFieldController
2. after value changed , you can get old value via FormeValueFieldController's oldValue
3. validate method add parameter notify , used to determine whether trigger errorListenable
4. FormeAsnycAutocompleteChipModel support max and exceedCallback.

1. bug fix: readOnlyNotifier will be disposed !

1. fields add InputDecoration and maxLines properties , used to quickly specify labelText or others
2. add FormeAsyncAutocompleteChip

1. add FormeAutocompleteText
2. add FormeAsyncAutocompleteText

1. StatefulField support onInitialed , used to listen FormeFieldController initialed
2. add FormeValidateUtils
3. bug fix : onValidationChanged and errorTextListenable not triggered in build

forme is completely rewrite version of https://pub.dev/packages/form_builder much more powerful and won't break your layout