Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

.NET MAUI BottomSheet States and Modality

  • 2 minutes to read

If you want to specify the expanded state of the BottomSheet control (FullExpanded, HalfExpanded, or Hidden), use the State property. To limit possible states, specify the AllowedState property. For example, you can select the All option to allow both HalfExpanded and FullExpanded states, or allow only one of them.

You can specify the bottom sheet height when it is in the Half-Expanded state. For this purpose, define the HalfExpandedRatio property.

HalfExpandedRatio = 0.3 HalfExpandedRatio = 0.7
DevExpress Bottom Sheet for MAUI - Half Expanded Ratio - 0.3 DevExpress Bottom Sheet for MAUI - Half Expanded Ratio - 0.3

#Visibility and Dismissal

Users can expand and collapse the BottomSheet control (“swipe up” and “swipe down” gestures). To disable the “swipe down” gesture, use the AllowDismiss property. A user can also tap outside the control to hide it (the State property value changes to Hidden).

Use the Show(BottomSheetState, Element) method to expand the bottom sheet, and Close(Action) or CloseAsync() methods to collapse it.

If you enable the IsModal property, the Bottom Sheet acts as a dialog page. It blocks the rest of the app UI until dismissed by a user. Note that runtime changes to the IsModal property have no effect on bottom sheet behavior.

DevExpress Bottom Sheet for MAUI -- Bottom sheet anatomy

You can enable the ShowGrabber property to show the drag handle.

#Limitations

  1. You cannot change the scrim color due to native component specifics.

  2. iOS platform: the HalfExpandedRatio property value is in effect for iOS 16 and later. In earlier versions, the HalfExpandedRatio value is always 0.5.