FormFieldState<T> class
Null safety
The current state of a FormField. Passed to the FormFieldBuilder method for use in constructing the form field's widget.
- Inheritance
- Mixed in types
Constructors
Properties
- bucket → RestorationBucket?
-
The RestorationBucket used for the restoration data of the
RestorablePropertys registered to this mixin.
read-onlyinherited
- context → BuildContext
-
The location in the tree where this widget builds.
read-onlyinherited
- errorText → String?
-
The current validation error returned by the FormField.validator
callback, or null if no errors have been triggered. This only updates when
validate is called.
read-only
- hasError → bool
-
True if this field has any validation errors.
read-only
- hashCode → int
-
The hash code for this object.
read-onlyinherited
- isValid → bool
-
True if the current value is valid.
read-only
- mounted → bool
-
Whether this State object is currently in a tree.
read-onlyinherited
- restorationId → String?
-
The restoration ID used for the RestorationBucket in which the mixin
will store the restoration data of all registered properties.
read-onlyoverride
- restorePending → bool
-
Whether restoreState will be called at the beginning of the next build
phase.
read-onlyinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-onlyinherited
- value → T?
-
The current value of the form field.
read-only
-
widget
→ FormField<
T> -
The current configuration.
read-onlyinherited
Methods
-
activate(
) → void - Called when this object is reinserted into the tree after having been removed via deactivate.
-
build(
BuildContext context) → Widget -
Describes the part of the user interface represented by this widget.
override
-
deactivate(
) → void -
Called when this object is removed from the tree.
override
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
inherited
-
didChange(
T? value) → void - Updates this field's state to the new value. Useful for responding to child widget changes, e.g. Slider's Slider.onChanged argument.
-
didChangeDependencies(
) → void -
Called when a dependency of this State object changes.
inherited
-
didToggleBucket(
RestorationBucket? oldBucket) → void - Called when bucket switches between null and non-null values.
-
didUpdateRestorationId(
) → void -
Must be called when the value returned by restorationId changes.
protected">@protectedinherited
-
didUpdateWidget(
covariant FormField< T> oldWidget) → void -
Called whenever the widget configuration changes.
inherited
-
dispose(
) → void -
Called when this object is removed from the tree permanently.
inherited
-
initState(
) → void - Called when this object is inserted into the tree.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed.
inherited
-
reassemble(
) → void - Called whenever the application is reassembled during debugging, for example during hot reload.
-
registerForRestoration(
RestorableProperty< Object?> property, String restorationId) → void -
Registers a RestorableProperty for state restoration.
protected">@protectedinherited
-
reset(
) → void - Resets the field to its initial value.
-
restoreState(
RestorationBucket? oldBucket, bool initialRestore) → void -
Called to initialize or restore the RestorablePropertys used by the
State object.
override
-
save(
) → void - Calls the FormField's onSaved method with the current value.
-
setState(
VoidCallback fn) → void -
Notify the framework that the internal state of this object has changed.
protected">@protectedinherited
-
setValue(
T? value) → void -
Sets the value associated with this form field.
protected">@protected
-
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
-
toStringShort(
) → String -
A brief description of this object, usually just the runtimeType and the
hashCode.
inherited
-
unregisterFromRestoration(
RestorableProperty< Object?> property) → void -
Unregisters a RestorableProperty from state restoration.
protected">@protectedinherited
-
validate(
) → bool - Calls FormField.validator to set the errorText. Returns true if there were no errors.
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited