forme 3.2.2+3 forme: ^3.2.2+3 copied to clipboard
a powerful flutter form widget ,easy to use and extend. provide rich api to simplify form control and sync|async validation
3.2.2 #
FormeController.fieldListenable
will triggered after frame completedFormeController
add fieldsListenable , used to listen every fieldForme
add onFieldsChanged- bug fix: when
Forme
's autovalidateMode is always , reset form will validate twice Forme
onValidationChanged renamed to onFieldValidationChangedForme
add onValidationChanged, used to listen FormeValidation changed
3.2.1 #
- bug fix
3.2.0 #
- support
enabled
onFormeField
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
- asyncValidator add a isValid function param ,API BREAK
- remove
comparator
fromFormeField
, you can overrideFormeFieldState
's compareValue method do the same - update dialog style of
FormeCupertinoDateTimeField
andFormeCupertinoTimerField
3.1.10 #
- support
FormeCheckboxTile
- support
FormeSwitchTile
3.1.8 #
- first argument of
FormeInputDecoratorBuilder
's emptyChecker has been replaced byT
3.1.6 #
- move to
FormeAutocomplete
&FormeAsyncAutocomplete
toforme_fields
package FormeInputDecoratorBuilder
's wrapper and emptyChecker addFormFieldController<T>
as second argument , this will break your codes
3.1.5 #
- replace EdgeInsets with EdgeInsetsGeometry in some files
- bug fix: if value in
FormeNumerTextField
bigger than max ,backspace will not work
3.1.4 #
- bug fix
3.1.3 #
FormeAsyncAutocomplete
can override default suffixIcon
3.1.2 #
- support set
FocusNode
inFormeFieldState
- support
FormeAutocomplete
FormeCheckbox
isbool?
now- support
FormeAsyncAutocomplete
3.1.1 #
- fix
FormeValidation
can not be found
3.1.0 #
- remove
hasValidator
onErrorChanged
renamed toonValidationChanged
FormeValidateError
renamed toFormeValidation
FormeValidateState
renamed toFormeValidationState
and add new stateunnecessary
andwaiting
3.0.1 #
- support
hasValidator
onFormeFieldController
- support
errorListenable
onFormeController
- add
FormeValidateErrorBuilder
widget - use
FormeField.of
getFormeFieldController
and it is nullable - use
Forme.of
getFormeController
and it is nullable
3.0.0 #
Forme3 is not an upgrade but a simple version of Forme2
differences:
- Forme3 removed model which used to provide render data in Forme2 and moved model properties into field's constructor
- Forme3 removed listener from field's constructor and moved listener properties into field's constructor
- Forme3 removed CommonField and renamed ValueField to FormeField
- Forme3 has big api breaks
- Forme3 is based on flutter 2.5
2.5.3 #
BaseValueField
supportquietlyValidate
FormeController
addfieldListenable
method , used to listen field's initial and dispose
2.5.2 #
FormeController
'svalidate
method supportclearError
andvalidateByOrder
params. ifclearError
is true , field error will be cleared before validate. ifvalidateByOrder
is true , will only validate one field at a time , and break validation chain if any field validate not passed or failed
2.5.1 #
- add
autovalidateByOrder
onForme
,support validate form fields by order , and stop validate further if validate failed - add a nullable attribute
order
onBaseValueField
Future<Map<FormeValueFieldController, String>> validate({bool quietly = false})
changed toFuture<FormeValidateSnapshot> validate({bool quietly = false, Set<String> names = const {}})
Future<String?>? validate({bool quietly = false})
changed toFuture<FormeFieldValidateSnapshot<T>> validate({bool quietly = false})
- add
isValueChanged
method onFormeController
, used to check whether form data changed after initialed
2.5.0 #
- remove
onValueChanged
,onValidationChanged
,onFocusChanged
,onInitialed
,validator
,autovalidateMode
onField
, they are moved toFormeFieldListener
,validator
is renamed toonValidate
- support
onAsyncValidate
andasyncValidatorDebounce
onFormeValueFieldListener
to support async validate - remove
fieldListenable
fromFormeFieldController
- remove
lazyFieldListenable
fromFormeKey
ValueField
is not aFormField
any more- you can create a nonnull or nullable
ValueField
byValueField
's generic type , eg:ValueField<String>
is nonnull , butValueField<String?>
is nullable - remove
clearValue
fromFormeValueFieldController
- support 'autovalidateMode' on
Forme
2.1.2 #
- remove
buildTextSpan
fromFormeTextFieldController
, it cannot be compiled success before flutter 2.2.2
2.1.1 #
- bug fix: can't get current field error in onValueChanged
FormeSingleSwitch
&FormeListTile
always use material switchFormeValidates
addrange
andequals
vaidator
2.1.0 #
- remove
Cupertino
fields ,they will be moved to another package FormeSlider
andFormeRangeSlider
will perform validate in onChangeEnd ,not in onChangeFormeTextField
's controller can be cast toFormeTextController
, setTextEditingValue
andSelection
is easily via this controllerFormeValueFieldController
supportnextFocus
, used to focus next focusable widget- remove
beforeUpdateModel
fromAbstractFieldState
, you can do some logic inafterUpdateModel
AbstractFieldState
's didUpdateWidget will callafterUpdateModel
by default- bug fix
2.0.4+1 #
- bug fix: timer in
FormeRawAutocomplete
will be cancelled in dispose !
2.0.4 #
- add
modelListenable
onFormeFieldController
- after value changed , you can get old value via
FormeValueFieldController
'soldValue
- validate method add parameter
notify
, used to determine whether triggererrorListenable
FormeAsnycAutocompleteChipModel
supportmax
andexceedCallback
.
2.0.3+1 #
- bug fix: readOnlyNotifier will be disposed !
2.0.3 #
- fields add
InputDecoration
andmaxLines
properties , used to quickly specific labelText or others - add
FormeAsyncAutocompleteChip
2.0.2 #
- add
FormeAutocompleteText
- add
FormeAsyncAutocompleteText
2.0.1 #
- StatefulField support
onInitialed
, used to listenFormeFieldController
initialed - add
FormeValidateUtils
- bug fix : onValidationChanged and errorTextListenable not triggered in build
2.0.0 #
forme is completely rewrite version of https://pub.dev/packages/form_builder much more powerful and won't break your layout