go_form 1.2.0

go_form: ^1.2.0 copied to clipboard

New Features #

• Added methods for subscribing to form validation state changes:

  • addValidationListener(void Function(bool) listener) – allows subscribing to form validation state changes (valid/invalid).
  • removeValidationListener(void Function(bool) listener) – removes a previously added validation listener.

• Added a new method in FieldController:

  • silentValidate() – performs field validation without setting an error and returns true if the field is valid or false if there is an error.

Added #

• Getter errorsKey: Returns a List<Key?> containing all elements with validation errors.
• Method firstFieldKey: Returns the Key of the first element in _fields, or null if _fields is empty.
• Method scrollToFirstField(): Automatically scrolls to the first field in _fields and requests focus.
• Method scrollToFirstErrorField(): Scrolls to the first field with an error and requests focus.
• Improved validation handling: now it's easier to locate and scroll to invalid fields.

Fixed #

• Resolved potential issues with Key handling in forms.

Usage #

Scroll to the first field

You can now automatically scroll to the first field in _fields:

scrollToFirstField();

New Features #

• Added documentation – full README with examples, API descriptions, and usage instructions.
• Added support for key – now widgets can be identified more easily in tests.

Improvements #

• Optimized dispose() in FormController – resources are now properly cleaned up.
• Enhanced handling of key properties – fields can now use keys for better identification.
• Optimized UI re-rendering – reduced unnecessary rebuilds.

Bug Fixes #

• Fixed memory leak issues related to dispose().
• Fixed test failures caused by missing key properties.
• Improved error handling in form validation.

Developer Experience #

• Added full documentation – with examples, project structure, and best practices.
• Added new tests – improved unit and widget test coverage.
• Cleaner and more efficient code – improved architecture and optimized UI updates.

Added #

• Introduced a named constructor DynamicForm.separator, allowing the use of separatorBuilder for custom separators between form fields.
• If separatorBuilder is provided, it will be used instead of the default SizedBox(height: fieldSpacing), offering greater flexibility in UI customization.

Example: #

DynamicForm.separator(
  fields: myFields,
  controller: myController,
  separatorBuilder: (context, index) => Divider(),
);

Fixes #

• Fixed issue with initialValue in the widget.

Fixes #

• Fixed the "name field is already in use" issue.
• Disabled protection against duplicate field creation.

Fixes #

• Fixed form reset issue.
• Fixed field data retrieval issue.

Added #

• Listener support: Introduced the ability to add, remove, and check listeners for FieldController and FormController.
  • New methods in FormController:
    • addListener(String name, VoidCallback listener): Attach a listener to a specific field.
    • removeListener(String name, VoidCallback listener): Detach a listener from a specific field.
    • hasListener(String name): Check if a field has listeners attached.
  • Enhancements to FieldController:
    • Stores and triggers custom listeners on value changes.
    • Exposes hasListeners to check if listeners are registered.

Fixed #

• Fixed an issue with generic type mismatch causing override errors in FormFieldModelBase.build.

• Added FieldController for form field state management.
• Support for TextFormField synchronization via TextEditingController.
• Added setValue method to FieldController for programmatically updating field values.
• Built-in validation and error handling.

• Initial release of the go_form plugin.

• Initial release of the go_form plugin.
• Key features:
  • Form controller