AbstractFormBuilder<B extends StateStreamableSource<S>, S extends AbstractFormBaseState> class

A widget for building forms with state management and event handling. This widget integrates with AbstractFormBaseState and provides callbacks for initialization, submission, success, and error handling.

Inheritance

Constructors

AbstractFormBuilder.new({Key? key, void onInit(BuildContext context)?, bool skipInitialOnInit = false, bool reinitOnSuccess = true, bool reinitOnLocalSuccess = false, Widget errorBuilder(BuildContext context, void onInit(), S state)?, Widget loaderBuilder(BuildContext context, S state)?, bool isLoading(BuildContext context, S state)?, bool shouldAutovalidate(BuildContext context, S state)?, bool isError(BuildContext context, S state)?, bool hasData(BuildContext context, S state)?, Widget? child, Widget extendedBuilder(BuildContext context, S state, B bloc, void submit())?, Widget builder(BuildContext context, S state)?, void listener(BuildContext context, S state)?, void onSuccess(BuildContext context, S state)?, void onLocalSuccess(BuildContext context, S state)?, void onError(BuildContext context, S state)?, void onLocalError(BuildContext context, S state)?, void onValidationError(BuildContext context, S state)?, B? providerValue, B provider(BuildContext context)?, List<SingleChildWidget>? providers})
Creates an AbstractFormBuilder.
const

Properties

builder Widget Function(BuildContext context, S state)?
Builder for rendering the form based on the current state.
final
child Widget?
The child widget to display if no custom builders are provided.
final
errorBuilder Widget Function(BuildContext context, void onInit(), S state)?
Builder for displaying an error state. Provides a callback to retry initialization.
final
extendedBuilder Widget Function(BuildContext context, S state, B bloc, void submit())?
Extended builder that provides access to the form state, bloc/cubit instance, and a submit callback for custom form rendering.
final
hasData bool Function(BuildContext context, S state)?
Custom function to determine if the form has data.
final
hashCode int
The hash code for this object.
no setterinherited
isError bool Function(BuildContext context, S state)?
Custom function to determine if the form is in an error state. If not provided, defaults to checking if the state is error.
final
isLoading bool Function(BuildContext context, S state)?
Custom function to determine if the form is in a loading state. If not provided, defaults to checking if the state is initializing.
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
listener → void Function(BuildContext context, S state)?
Listener for state changes. Can be used to perform side effects based on the form's state.
final
loaderBuilder Widget Function(BuildContext context, S state)?
Builder for displaying a loading state.
final
onError → void Function(BuildContext context, S state)?
Callback triggered when the form submission encounters an error.
final
onInit → void Function(BuildContext context)?
Callback triggered when the form is initialized. This can be used to perform custom initialization logic.
final
onLocalError → void Function(BuildContext context, S state)?
Callback triggered when the local form submission encounters an error.
final
onLocalSuccess → void Function(BuildContext context, S state)?
Callback triggered when the local form submission is successful.
final
onSuccess → void Function(BuildContext context, S state)?
Callback triggered when the form submission is successful.
final
onValidationError → void Function(BuildContext context, S state)?
Callback triggered when the form validation fails.
final
provider → B Function(BuildContext context)?
A function to create the bloc/cubit instance. Used if providerValue is not provided.
final
providers List<SingleChildWidget>?
A list of additional providers to wrap around the form.
final
providerValue → B?
The bloc/cubit instance to use. If provided, the widget will not create a new instance.
final
reinitOnLocalSuccess bool
If true, reinitializes the form after a successful local submission. Defaults to false.
final
reinitOnSuccess bool
If true, reinitializes the form after a successful submission. Defaults to true.
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
shouldAutovalidate bool Function(BuildContext context, S state)?
Custom function to determine if the form should auto-validate.
final
skipInitialOnInit bool
If true, skips the initial onInit call when the widget is first built. Defaults to false.
final

Methods

build(BuildContext context) Widget
Describes the part of the user interface represented by this widget.
override
createElement() StatelessElement
Creates a StatelessElement to manage this widget's location in the tree.
inherited
debugDescribeChildren() List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a one-line detailed description of the object.
inherited
toStringShort() String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited