feat: add loading animation control for historical data

Author: z-chu

lib/src/deriv_chart/chart/chart.dart

@@ -77,6 +77,7 @@ class Chart extends StatefulWidget {
     this.bottomChartTitleMargin,
     this.showDataFitButton,
     this.showScrollToLastTickButton,
+    this.showLoadingAnimationForHistoricalData = true,
     this.loadingAnimationColor,
     this.useDrawingToolsV2 = false,
     this.enableYAxisScaling = true,
@@ -188,6 +189,14 @@ class Chart extends StatefulWidget {
   /// Whether to show the scroll to last tick button or not.
   final bool? showScrollToLastTickButton;
 
+  /// Whether to show the loading animation for historical data.
+  ///
+  /// When set to `false`, the loading animation will always be hidden.
+  /// When set to `true` (default), the visibility will be determined by
+  /// the [dataFitEnabled] property (hidden when dataFitEnabled is true,
+  /// shown otherwise).
+  final bool showLoadingAnimationForHistoricalData;
+
   /// The color of the loading animation.
   final Color? loadingAnimationColor;
 

lib/src/deriv_chart/chart/chart_state_mobile.dart

@@ -125,7 +125,9 @@ class _ChartStateMobile extends _ChartState {
                   onCrosshairAppeared: widget.onCrosshairAppeared,
                   onQuoteAreaChanged: widget.onQuoteAreaChanged,
                   isLive: widget.isLive,
-                  showLoadingAnimationForHistoricalData: !widget.dataFitEnabled,
+                  showLoadingAnimationForHistoricalData:
+                      widget.showLoadingAnimationForHistoricalData &&
+                          !widget.dataFitEnabled,
                   showDataFitButton:
                       widget.showDataFitButton ?? widget.dataFitEnabled,
                   showScrollToLastTickButton:

lib/src/deriv_chart/chart/chart_state_web.dart

@@ -30,7 +30,9 @@ class _ChartStateWeb extends _ChartState {
             onCrosshairAppeared: widget.onCrosshairAppeared,
             onQuoteAreaChanged: widget.onQuoteAreaChanged,
             isLive: widget.isLive,
-            showLoadingAnimationForHistoricalData: !widget.dataFitEnabled,
+            showLoadingAnimationForHistoricalData:
+                widget.showLoadingAnimationForHistoricalData &&
+                    !widget.dataFitEnabled,
             showDataFitButton:
                 widget.showDataFitButton ?? widget.dataFitEnabled,
             showScrollToLastTickButton:

lib/src/deriv_chart/deriv_chart.dart

@@ -66,6 +66,7 @@ class DerivChart extends StatefulWidget {
     this.bottomChartTitleMargin,
     this.showDataFitButton,
     this.showScrollToLastTickButton,
+    this.showLoadingAnimationForHistoricalData = true,
     this.loadingAnimationColor,
     this.crosshairVariant = CrosshairVariant.smallScreen,
     this.interactiveLayerBehaviour,
@@ -174,6 +175,14 @@ class DerivChart extends StatefulWidget {
   /// Whether to show the scroll to last tick button or not.
   final bool? showScrollToLastTickButton;
 
+  /// Whether to show the loading animation for historical data.
+  ///
+  /// When set to `false`, the loading animation will always be hidden.
+  /// When set to `true` (default), the visibility will be determined by
+  /// the [dataFitEnabled] property (hidden when dataFitEnabled is true,
+  /// shown otherwise).
+  final bool showLoadingAnimationForHistoricalData;
+
   /// The color of the loading animation.
   final Color? loadingAnimationColor;
 
@@ -409,6 +418,8 @@ class _DerivChartState extends State<DerivChart> {
                 bottomChartTitleMargin: widget.bottomChartTitleMargin,
                 showDataFitButton: widget.showDataFitButton,
                 showScrollToLastTickButton: widget.showScrollToLastTickButton,
+                showLoadingAnimationForHistoricalData:
+                    widget.showLoadingAnimationForHistoricalData,
                 loadingAnimationColor: widget.loadingAnimationColor,
                 chartAxisConfig: widget.chartAxisConfig,
                 crosshairVariant: widget.crosshairVariant,