Provide CollapseOnOverlayTap support for Maui Bottom Sheet

Author: naveenkumar-sanjeevirayan

maui/src/BottomSheet/SfBottomSheet.cs

@@ -455,6 +455,20 @@ public partial class SfBottomSheet : SfView, IParentThemeElement
 		    BindingMode.Default, 
 		    propertyChanged: OnGrabberCornerRadiusPropertyChanged);
 
+		/// <summary>
+		/// Identifies the <see cref="CollapseOnOverlayTap"/> bindable property.
+		/// </summary>
+		/// <value>
+		/// The identifier for <see cref="CollapseOnOverlayTap"/> bindable property.
+		/// </value>
+		public static readonly BindableProperty CollapseOnOverlayTapProperty = BindableProperty.Create(
+			nameof(CollapseOnOverlayTap),
+			typeof(bool),
+			typeof(SfBottomSheet),
+			false,
+			BindingMode.Default
+			);
+
 		#endregion
 
 		#region Internal Bindable Properties
@@ -781,6 +795,18 @@ public CornerRadius GrabberCornerRadius
 		    set => SetValue(GrabberCornerRadiusProperty, value);
 		}
 
+		/// <summary>
+		/// Gets or sets whether the bottom sheet should collapse to its minimum height instead of closing when tapping outside.
+		/// </summary>
+		/// <value>
+		/// It accepts Boolean values, and the default value is <c>false</c>.
+		/// </value>
+		public bool CollapseOnOverlayTap
+		{
+			get => (bool)GetValue(CollapseOnOverlayTapProperty);
+			set => SetValue(CollapseOnOverlayTapProperty, value);
+		}
+
 		#endregion
 
 		#region Internal Properties
@@ -1201,7 +1227,14 @@ void OnOverlayGridTapped(object? sender, EventArgs e)
 		{
 		    if (_isSheetOpen)
 		    {
-		        Close();
+		        if(CollapseOnOverlayTap)
+				{
+					State = BottomSheetState.Collapsed;
+				}
+				else
+				{
+					Close();
+				}
 		    }
 		}
 
@@ -1524,7 +1557,7 @@ void UpdateStateChanged(BottomSheetState oldState, BottomSheetState newState)
 		            _overlayGrid.IsVisible = (State is BottomSheetState.Collapsed) ? false : IsModal;
 		        }
 
-		        OnStateChanged(_stateChangedEventArgs);
+				OnStateChanged(_stateChangedEventArgs);
 		    }
 		}
 
@@ -1616,7 +1649,7 @@ double GetCollapsedPosition()
 				_overlayGrid.IsVisible = false;
 			}
 
-		    return targetPosition;
+			return targetPosition;
 		}
 
 		/// <summary>
@@ -1767,7 +1800,7 @@ bool ShouldRestrictMovement(double newTranslationY, double diffY)
 		        return false;
 		    }
 
-		    bool isHalfExpandedAndRestricted = State is BottomSheetState.HalfExpanded &&
+			bool isHalfExpandedAndRestricted = State is BottomSheetState.HalfExpanded &&
 		                                       AllowedState is BottomSheetAllowedState.HalfExpanded &&
 		                                       _bottomSheet.TranslationY > newTranslationY;
 

maui/tests/Syncfusion.Maui.Toolkit.UnitTest/Navigation/SfBottomSheetUnitTests.cs

@@ -450,6 +450,18 @@ public void CollapsedHeight(double input, double expected)
 			Assert.Equal(expected, actual);
 		}
 
+		[Theory]
+		[InlineData(true, true)]
+		[InlineData(false, false)]
+		public void CollapseOnOverlayTap(bool input, bool expected)
+		{
+			_bottomSheet.CollapseOnOverlayTap = input;
+
+			var actual = _bottomSheet.CollapseOnOverlayTap;
+
+			Assert.Equal(expected, actual);
+		}
+
 		#endregion
 
 		#region Internal Properties