formx 0.16.0
formx: ^0.16.0 copied to clipboard
Access, build, validate, sanitize and fill forms easily with Formx.
Changelog #
This project adheres to Semantic Versioning.
0.16.0 Jun 27, 2024 #
- Added
FieldKeyclass andKeyadapter & modifiers extensions. - Make
unmaskfeature independant ofmask_text_input_formatterinternal state. - Deprecated all field apis inside
FormState. Usecontext.fieldinstead. - Added
DateFormFieldwidget. - Added
FormxOption.dateAdapterto format date inFormState.values.
0.15.0 Jun 24, 2024 #
- Added
FormxOptionsclass. - Added
Formx.optionsstatic variable. - Added
FormState.rawValuesgetter. - Updated
FormState.valuesgetter. - Added
FormState.customValuesmethod. - Added
FormState.debugmethod. - Added
context.debugFormmethod extension. - Added
IndentedMap.offactory constructor. - Included
mask_text_input_formatter. - Updated docs & README.
0.14.0 Jun 21, 2024 #
- Added
RadioListFormField.
0.13.0 Jun 19, 2024 #
- Added
CheckboxFormField. - Added
CheckboxListFormField. - Bump
string_validatorto 1.1.0.
0.12.2 May 22, 2024 #
- Added
List.mapJsonextension.
0.12.1 May 22, 2024 #
- Improved sanitizers and validators.
0.11.0 May 2, 2024 #
- Added
Validator.translatorfor translating error messages. - Removed
Validator.modifier.
Thanks to lizandraquaresma for the translator feature!
0.10.4 Apr 25, 2024 #
- Added several
Validatorextensions. - Updated
Map.cleanand addedMap.cleanedextension. - Updated
README.md. - Updated tests.
0.10.1 Apr 24, 2024 #
- Refactor: removed all
if case whenas they're not working on flutter web.
0.10.0 Apr 23, 2024 #
Breaking Update.
- Removed
Formxwidget in favor ocontext.formx(). - Added new
README.md.
0.9.2 Mar 25, 2024 #
- Added
Validator.testshorthand constructor with positional parameters. - Added
Map.cleanextension to remove null and empty values. - Fixed
FormState.setErrorTextthat was never reseting on validation. - Changed
FormState.setErrorTextto accept null to remove the errorText. - Updated examples and README.
0.9.1 Mar 22, 2024 #
- Fixed validation priority order.
0.9.0 Mar 21, 2024 #
- Changed
FormxBuildertypedef to followFormFieldBuildersignature from Flutter. - Added
FormxCastExtensionwithcastandtryCast.
0.8.0 Feb 24, 2024 #
Validator was cleaned up and simplified. Now it's a declarative class that can be used to create custom validators.
- Added
validatorsproperty toValidatorclass. - Removed
Validator.mergeconstructor, useValidator.validatorsinstead. - Removed
Validatormodifiers to make it excluively declarative. UseValidator.validatorsinstead.
0.7.1 Feb 12, 2024 #
- Added
Validatorclass to simplify the creation of custom validators. - Added
Validator.modifierto modify the errorText of a validator. - Added
FormFieldState.setErrorTextto seterrorTextprogrammatically. - Added smart AutovalidateMode to Formx. If null, starts with
AutovalidateMode.disabledand changes toAutovalidateMode.alwayswhen validated. - Added smart operators to FormxState, to get and set fields/nesteds.
- Added reset to FormxState, to reset all fields to their initial values.
0.7.0 Feb 10, 2024 #
Completely simplification of the library. Now Formx works with any FormField Widget! No need to use custom fields anymore. You can use TextFormField, DropdownButtonFormField or wrap/extend any widget to a FormField. Just add a key to it and you are good to go!
- Removed
TextFormxField,TextFormxFieldStateand it's extensions.
We realized that using extensions and callback modifiers was misleading users to use only the "new" approach. Which introduces unnecessaries new api's. We want to make it easier for developers to use Formx, as well as for others to understand it.
- Removed
errorTextModifier,fieldModifier,fieldWrapper,decorator,fieldWrapper,fieldModifierandvalueModifiercallbacks.
Formx is now a single widget that manages fields and their states.
0.6.1 Jan 30, 2024 #
- Changes
TextFormxFieldtag to named parameter. - Adds
FormxState.fieldto get a field value by tag, no matter how deep it is. - Adds
Formx.builderparameter for context and state access. - Added
TextFormxFieldState.hasInteractedByUser, same asFormFieldState.hasInteractedByUser. - Removed
Formx.at. - Changed
decorationModifiertodecorator.
0.5.1 Jan 23, 2024 #
- Added
Formx.disableValidatorsOnDebugModeto disable validators on debug mode. - Added
suffixIconextension toTextFormxFieldModifiers. - Added
prefixIconextension toFormxFieldModifiers.
0.5.0 Nov 13, 2023 #
- Added
FormxFieldandFormxFieldStateabstract interfaces.- Updated [FormxState.validate] you can validate by tag, tags, key or keys.
- Added [FormxState.setValue].
- Added [FormxState.didChange].
- Removed fieldKey param, use key directly with
FormxFieldStatefor GlobalKey type. - Removed FormxException. AssertErrors will be thrown instead, for best practices.
- Changes
TextFormxFieldModifiers.obscure, which now also makes the field required. - Added
complex_structureexample. - Added
page_viewexample.
0.4.0 Nov 07, 2023 #
-
Adds [Formx.valueModifier] and updates [FormxState.form] getter.
-
Adds [FormxState.save] and [Formx.onSaved] callback.
-
Adds [FormxState.reset].
-
Adds [FormxState.isValid].
-
Adds [FormxState.hasError].
-
Changes
onWidgettofieldWrapper. -
Changes
onFieldtofieldModifier. -
Changes
onDecorationtodecorationModifier. -
Changes
onErrorTexttoerrorTextModifier. -
Updates in code were made to better follow Effective Dart style and also improve developer experience:
- Adds
all_lint_rules.yaml. - Updates
analysis_optionsfor stricter lints. - Updates CHANGELOG style.
- Adds
0.3.13 Oct 23, 2023 #
- Bump to Flutter sdk 3.13.0.
- Adds support to TextFormField in sdk 3.13.0.
- Adds
undoControllerto TextFormxField. - Adds
onAppPrivateCommandto TextFormxField. - Adds
cursorOpacityAnimatesto TextFormxField. - Adds
selectionHeightStyleto TextFormxField. - Adds
selectionWidthStyleto TextFormxField. - Adds
dragStartBehaviorto TextFormxField. - Adds
contentInsertionConfigurationto TextFormxField. - Adds
clipBehaviorto TextFormxField. - Adds
scribbleEnabledto TextFormxField. - Adds
canRequestFocusto TextFormxField.
0.3.10 Oct 23, 2023 #
- Bump to Flutter sdk 3.10.0.
- Adds support to TextFormField in sdk 3.10.0.
- Adds
spellCheckConfigurationto TextFormxField. - Adds
magnifierConfigurationto TextFormxField.
0.3.7 Oct 23, 2023 #
- Bump to Flutter sdk 3.7.0.
- Adds support to TextFormField in sdk 3.7.0.
- Adds
contextMenuBuilderto TextFormxField. - Adds
onTapOutsideto TextFormxField.
0.3.0 Oct 23, 2023 #
- Adds support to TextFormField in sdk 3.0.0
- Adds FormxState.fill() method to autofill all nested fields.
- Adds Formx.at(context) and
maybeAtto access state below context. - Adds
Formx.errorTextsto access allerrorTextsby fieldtag. - Updates
FormxExceptionwith errorTexts parameter.
0.1.5 Sep 26, 2023 #
- Fixes initialValue conflict with TextEditingController.
- Fixes unnecessary didChange on setField.
0.1.1 Sep 23, 2023 #
- Fixes minor conflict with [onField].
0.1.0 Sep 22, 2023 #
- Initial pre-release.