4.10.0

CHANGELOG.md

@@ -1,4 +1,11 @@
 
+## 4.10.0
+January 24, 2023
+- StateX({StateXController? controller, bool? runAsync, bool? useInherited}) {
+  A new optional parameter, runAsync, to run built-in FutureBuilder with every build
+- abstract class StateF<T extends StatefulWidget> extends StateX<T>
+  A State class to run built-in FutureBuilder with every build
+
 ## 4.9.0
 December 14, 2023
 - getter buildOverridden & buildFOverridden set when 'build' functions are overwritten 

lib/state_extended.dart

@@ -49,10 +49,12 @@ abstract class StateX<T extends StatefulWidget> extends State<StatefulWidget>
     implements
         StateListener {
   //
-  /// With an optional StateXController parameter and built-in InheritedWidget use
-  StateX({StateXController? controller, bool? useInherited}) {
+  /// With an optional StateXController parameter and built-in FutureBuilder & InheritedWidget use
+  StateX({StateXController? controller, bool? runAsync, bool? useInherited}) {
     // Add to the list of StateX objects present in the app!
     _addToMapOfStates(this);
+    // A flag whether the built-in FutureBuilder runs with every setState() call.
+    _runAsync = runAsync ?? false;
     // A flag determining whether the built-in InheritedWidget is used or not.
     _useInherited = useInherited ?? false;
     // Associate the controller to this State object
@@ -63,6 +65,9 @@ abstract class StateX<T extends StatefulWidget> extends State<StatefulWidget>
 
   StateXController? _controller;
 
+  /// Run the built-in FutureBuilder with every setState() call
+  late bool _runAsync;
+
   /// Use this function instead of build() to use the built-in InheritedWidget.
   @override
   @protected
@@ -1169,6 +1174,11 @@ abstract class StateX<T extends StatefulWidget> extends State<StatefulWidget>
         /// Refresh the interface by 'rebuilding' the Widget Tree
         /// Call the State object's setState() function.
         super.setState(fn);
+
+        if (_ranAsync && _runAsync) {
+          // Run the FutureBuilder again and again
+          _ranAsync = false;
+        }
       }
       _setStateAllowed = true;
     } else {
@@ -1190,6 +1200,16 @@ abstract class StateX<T extends StatefulWidget> extends State<StatefulWidget>
   }
 }
 
+/// A State object the runs its built-in FutureBuilder with every setState()
+///
+/// dartdoc:
+/// {@category StateX class}
+abstract class StateF<T extends StatefulWidget> extends StateX<T> {
+  ///
+  StateF({StateXController? controller})
+      : super(controller: controller, runAsync: true);
+}
+
 /// A State object that explicitly implements a built-in InheritedWidget
 ///
 /// dartdoc:

pubspec.yaml

@@ -1,6 +1,6 @@
 name: state_extended
 description: This class extends the capabilities of Flutter's State class and includes a controller.
-version: 4.9.0
+version: 4.10.0
 homepage: https://www.andrioussolutions.com
 repository: https://github.com/AndriousSolutions/state_extended