FieldBaseState<T extends StatefulWidget> class abstract

Abstract base class for form field widget states.

FieldBaseState extends NyState to provide common functionality for form field widgets including styling, validation, and layout management. All form field widgets should extend this class to ensure consistent behavior and integration with the form system.

Type parameter T should be the StatefulWidget class that this state manages.

Inheritance

Constructors

FieldBaseState(Field field)
Creates a FieldBaseState with the associated field configuration.

Properties

allowStateUpdates → bool
Check if the state should listen for events via the EventBus.
no setterinherited
context → BuildContext
The location in the tree where this widget builds.
no setterinherited
eventBus → EventBus?
Helper to get the EventBus.
no setterinherited
eventSubscription ↔ StreamSubscription?
The eventSubscription is used to listen for UpdateState events.
getter/setter pairinherited
field ↔ Field
The field configuration and data container for this widget.
getter/setter pair
hashCode → int
The hash code for this object.
no setterinherited
hasInitComplete ↔ bool
Check if the initState has already been loaded.
getter/setter pairinherited
init → dynamic Function()
Initialize your widget in init.
no setterinherited
loadingStyle → LoadingStyle
Define the LoadingStyle for the widget.
no setterinherited
mediaQuery → MediaQueryData
Helper to get the MediaQueryData.
no setterinherited
mounted → bool
Whether this State object is currently in a tree.
no setterinherited
overrideLoading ↔ bool
Override the loading state.
getter/setter pairinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
shouldLoadView → bool
Check if the widget should be loaded.
no setterinherited
stateActions → Map<String, Function>
Get the state actions
no setterinherited
stateData ↔ dynamic
The stateData contains the last value set from a updateState() call.
getter/setter pairinherited
stateName ↔ String?
The stateName is used as the ID for the UpdateState class.
getter/setter pairinherited
style → FieldStyle
Returns the styling configuration for this field.
no setter
surfaceColorDark ↔ Color
Default surface color used for dark theme field backgrounds.
getter/setter pair
textTheme → TextTheme
Helper to get the TextTheme.
no setterinherited
widget → T
The current configuration.
no setterinherited

Methods

activate() → void
Called when this object is reinserted into the tree after having been removed via deactivate.
inherited
afterLoad({required dynamic child(), Widget? loading, String? loadingKey}) → Widget
The afterLoad method will check if the state is loading If loading it will display the loading widget. You can also specify the name of the loadingKey.
inherited
afterNotLocked(String name, {required dynamic child(), Widget? loading}) → Widget
The afterNotLocked method will check if the state is locked, if the state is locked it will display the loading widget.
inherited
afterNotNull(dynamic variable, {required dynamic child(), Widget? loading}) → Widget
The afterNotNull method will check if the variable passed in is null If the variable is not null, it will display the loading widget.
inherited
awaitData({String name = 'default', required Function perform, bool shouldSetStateBefore = true, bool shouldSetStateAfter = true}) → Future<void>
Use the awaitData method when initial fetching data for a widget. E.g. When your page first loads and you want to populate your widgets with data.
inherited
build(BuildContext context) → Widget
Build the widget
override
changeLanguage(String language, {bool restartState = true}) → Future<void>
Update the language in the application
inherited
check(dynamic validate(List<FormValidator>), {dynamic onSuccess()?, dynamic onValidationError(FormValidationResponseBag)?}) → FormValidationResponseBag
Check the validation of the data against the rules Returns a FormValidationResponse indicating success or error
inherited
color({Color? light, Color? dark}) → Color
Get the color based on the device mode
inherited
confirmAction(dynamic action(), {required String title, String dismissText = "nylo.confirm_action.cancel", String confirmText = "nylo.confirm_action.confirm", CupertinoThemeData? cupertinoThemeData, ThemeData? themeData, Color barrierColor = kCupertinoModalBarrierColor, bool barrierDismissible = true, bool useRootNavigator = true, bool semanticsDismissible = false, RouteSettings? routeSettings, Offset? anchorPoint}) → void
Allow the user to confirm an action. Provide a title for the confirm button. You can also provide a dismissText for the cancel button. E.g. confirmAction(() { ... perform action }, title: "Delete account?", dismissText: "Cancel");
inherited
data<T>({dynamic defaultValue}) → T?
Get data from the NyStatefulWidget controller.
inherited
deactivate() → void
Called when this object is removed from the tree.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
didChangeDependencies() → void
Called when a dependency of this State object changes.
inherited
didUpdateWidget(covariant T oldWidget) → void
Called whenever the widget configuration changes.
override
dispose() → void
Called when this object is removed from the tree permanently.
inherited
getFooterSpacing() → double
Returns the vertical spacing below the field footer.
getHeaderSpacing() → double
Returns the vertical spacing above the field header.
getWidgetStateProperty<T>(Widget? widgetData, {Icon? defaultValue}) → WidgetStateProperty<T>?
Creates a WidgetStateProperty for generic widget properties.
getWidgetStatePropertyColor(Color? colorMetaData, {Color? defaultValue}) → WidgetStateProperty<Color>?
Creates a WidgetStateProperty for colors with theme-aware fallbacks.
hasQueryParameter(String key) → bool
Check if the queryParameters contains a specific key.
inherited
initState() → void
Called when this object is inserted into the tree.
inherited
isLoading({String name = 'default'}) → bool
Checks the value from your loading map. Provide the name of the loader.
inherited
isLocked(String name) → bool
Checks the value from your lock map. Provide the name of the lock.
inherited
listen<E extends NyEvent>(dynamic callback(Map? data)) → NyEventSubscription<NyEvent>
Listen to an event with a callback function Returns a subscription reference that can be used to cancel later
inherited
lockRelease(String name, {required Function perform, bool shouldSetState = true}) → Future<void>
The lockRelease method will call the function provided in perform and then block the function from being called again until it has finished.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
pop({dynamic result}) → void
Pop the current widget from the stack.
inherited
pushTo(Widget page, {dynamic data, dynamic onPop(dynamic value)?}) → void
Push to a new page
inherited
queryParameters({String? key}) → dynamic
Get queryParameters from the NyStatefulWidget controller.
inherited
reassemble() → void
Called whenever the application is reassembled during debugging, for example during hot reload.
inherited
reboot() → Future<void>
Reboot your widget.
inherited
setLoading(bool value, {String name = 'default', bool resetState = true}) → void
Set the value of a loading key by padding a true or false
inherited
setState(VoidCallback fn) → void
Notify the framework that the internal state of this object has changed.
inherited
showToast({String id = 'success', String? title, String? description, Duration? duration}) → void
Show a toast notification. Use id to specify the toast style (e.g., "success", "warning", "info", "danger"). You can also use custom style IDs registered via Nylo.addToastNotifications.
inherited
showToastCustom({String? title, String? description, String? id}) → void
Display a custom Toast message.
inherited
showToastDanger({String? title, required String description}) → void
Displays a Toast message containing "Error" for the title, you only need to provide a description.
inherited
showToastInfo({String? title, required String description}) → void
Displays a Toast message containing "Info" for the title, you only need to provide a description.
inherited
showToastOops({String? title, required String description}) → void
Displays a Toast message containing "Oops" for the title, you only need to provide a description.
inherited
showToastSorry({String? title, required String description}) → void
Displays a Toast message containing "Sorry" for the title, you only need to provide a description.
inherited
showToastSuccess({String? title, required String description}) → void
Displays a Toast message containing "Success" for the title, you only need to provide a description.
inherited
showToastWarning({String? title, required String description}) → void
Displays a Toast message containing "Warning" for the title, you only need to provide a description.
inherited
stateUpdated(dynamic data) → Future<void>
When you call updateState, this method will be called within your State. The data parameter will contain any data passed from the updateState method.
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
toStringShort() → String
A brief description of this object, usually just the runtimeType and the hashCode.
inherited
view(BuildContext context) → Widget
Override this method to define the main field widget content.
override
whenEnv(String env, {required Function perform, bool shouldSetState = true}) → Future<void>
Perform an action when the application's env is in a certain state
inherited
whenStateAction(Map<String, Function> actions) → void
Handle what happens when an action is called actions is a map of actions
inherited
whenTheme<T>({required T light(), T dark()?}) → T
When the theme is in light mode, return light function, else return dark function
override

Operators

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