Merge pull request #55 from nadavfima/toolbar-gradient-parameter

feat: add enableToolbarGradient option to AdaptiveScaffold and iOS26 components for enhanced UI customization

Author: berkaycatak

lib/src/widgets/adaptive_scaffold.dart

@@ -69,6 +69,7 @@ class AdaptiveScaffold extends StatefulWidget {
     this.floatingActionButton,
     this.minimizeBehavior = TabBarMinimizeBehavior.automatic,
     this.enableBlur = true,
+    this.enableToolbarGradient = true,
     this.extendBodyBehindAppBar = false,
   });
 
@@ -94,6 +95,9 @@ class AdaptiveScaffold extends StatefulWidget {
   /// When enabled, content behind the tab bar will be blurred
   final bool enableBlur;
 
+  /// Enable gradient at the top of the toolbar (iOS 26+ only)
+  /// When enabled, a gradient fade effect is applied to the top toolbar
+  final bool enableToolbarGradient;
   /// Whether to extend the body behind the app bar (iOS only)
   /// When true, the body will extend behind the app bar, allowing for
   /// immersive content. When false, the body will start below the app bar.
@@ -169,6 +173,7 @@ class _AdaptiveScaffoldState extends State<AdaptiveScaffold> {
         leading: widget.appBar?.leading,
         minimizeBehavior: widget.minimizeBehavior,
         enableBlur: widget.enableBlur,
+        enableToolbarGradient: widget.enableToolbarGradient,
         children: childrenList,
       );
     }

lib/src/widgets/ios26/ios26_native_toolbar.dart

@@ -18,6 +18,7 @@ class IOS26NativeToolbar extends StatefulWidget {
     this.onLeadingTap,
     this.onActionTap,
     this.height = 44.0,
+    this.enableGradient = true,
   });
 
   final String? title;
@@ -27,6 +28,7 @@ class IOS26NativeToolbar extends StatefulWidget {
   final VoidCallback? onLeadingTap;
   final ValueChanged<int>? onActionTap;
   final double height;
+  final bool enableGradient;
 
   @override
   State<IOS26NativeToolbar> createState() => _IOS26NativeToolbarState();
@@ -58,26 +60,28 @@ class _IOS26NativeToolbarState extends State<IOS26NativeToolbar> {
 
     final toolbar = Container(
       height: widget.height + safePadding,
-      decoration: BoxDecoration(
-        gradient: Theme.brightnessOf(context) == Brightness.light
-            ? const LinearGradient(
-                colors: [
-                  Color.fromARGB(229, 255, 255, 255),
-                  Color.fromARGB(0, 255, 255, 255),
-                ],
-                begin: Alignment.topCenter,
-                end: Alignment.bottomCenter,
-              )
-            : const LinearGradient(
-                colors: [
-                  Color.fromARGB(234, 0, 0, 0),
-                  Color.fromARGB(137, 0, 0, 0),
-                  Color.fromARGB(0, 0, 0, 0),
-                ],
-                begin: Alignment.topCenter,
-                end: Alignment.bottomCenter,
-              ),
-      ),
+      decoration: widget.enableGradient
+          ? BoxDecoration(
+              gradient: Theme.brightnessOf(context) == Brightness.light
+                  ? const LinearGradient(
+                      colors: [
+                        Color.fromARGB(229, 255, 255, 255),
+                        Color.fromARGB(0, 255, 255, 255),
+                      ],
+                      begin: Alignment.topCenter,
+                      end: Alignment.bottomCenter,
+                    )
+                  : const LinearGradient(
+                      colors: [
+                        Color.fromARGB(234, 0, 0, 0),
+                        Color.fromARGB(137, 0, 0, 0),
+                        Color.fromARGB(0, 0, 0, 0),
+                      ],
+                      begin: Alignment.topCenter,
+                      end: Alignment.bottomCenter,
+                    ),
+            )
+          : null,
       child: UiKitView(
         viewType: 'adaptive_platform_ui/ios26_toolbar',
         creationParams: creationParams,

lib/src/widgets/ios26/ios26_scaffold.dart

@@ -15,6 +15,7 @@ class IOS26Scaffold extends StatefulWidget {
     this.leading,
     this.minimizeBehavior = TabBarMinimizeBehavior.automatic,
     this.enableBlur = true,
+    this.enableToolbarGradient = true,
     required this.children,
   });
 
@@ -24,6 +25,7 @@ class IOS26Scaffold extends StatefulWidget {
   final Widget? leading;
   final TabBarMinimizeBehavior minimizeBehavior;
   final bool enableBlur;
+  final bool enableToolbarGradient;
   final List<Widget> children;
 
   @override
@@ -169,6 +171,7 @@ class _IOS26ScaffoldState extends State<IOS26Scaffold>
                   widget.actions![index].onPressed();
                 }
               },
+              enableGradient: widget.enableToolbarGradient,
             ),
           ),
         // Tab bar - only show if destinations exist

lib/src/widgets/ios26/ios26_scaffold_legacy.dart

@@ -18,6 +18,7 @@ class IOS26ScaffoldLegacy extends StatefulWidget {
     this.leading,
     this.minimizeBehavior = TabBarMinimizeBehavior.automatic,
     this.enableBlur = true,
+    this.enableToolbarGradient = true,
     required this.children,
   });
 
@@ -29,6 +30,7 @@ class IOS26ScaffoldLegacy extends StatefulWidget {
   final Widget? leading;
   final TabBarMinimizeBehavior minimizeBehavior;
   final bool enableBlur;
+  final bool enableToolbarGradient;
   final List<Widget> children;
 
   @override
@@ -146,6 +148,7 @@ class _IOS26ScaffoldLegacyState extends State<IOS26ScaffoldLegacy>
                     widget.actions![index].onPressed();
                   }
                 },
+                enableGradient: widget.enableToolbarGradient,
               ),
             ),
             // Tab bar - only show if destinations exist